Skip to content

v3.0.0

Compare
Choose a tag to compare
@Shazwazza Shazwazza released this 15 Sep 05:04
· 387 commits to develop since this release

Hooray! v3.0.0 is finally out :) (though this is released under 3.0.1)

This is an enormous release!! check out the milestone: https://github.com/Shazwazza/Articulate/milestone/11?closed=1

This release requires a minimum Umbraco version of 7.6.x and also supports the upcoming 7.7 release.

Articulate is even on Nuget now:

PM> Install-Package Articulate

New Installs

Via Nuget

Articulate will add an Articulate dashboard in the developer section. If you install via Nuget, then you won't have the Articulate data automatically installed for you so once you load up your back office, go to the 'Install' tab on that dashboard and press install

image

Via Back office

If you install Articulate through the back office - it's just like it was before and Articulate will populate all of the demo data automatically. https://our.umbraco.org/projects/starter-kits/articulate/

Upgrading

The only tricky part about the upgrade process will be getting your templates updated to have some of the new features. If you don't care about those then chance are you don't have to do much but here's some instructions to get you going:

Backup everything first

  • Hopefully you are using source control so you can see what's changed. If not .... hrm, you might want to do that before you install else it's going to be difficult for you to see whats changed in the template files.
  • Rename App_Plugins/Articulate to App_Plugins/Articulate_Bak - since you didn't use Nuget before that will probably be required
  • Install the package
    • If you wish to move to a Nuget installation, you 'should' be able to just run the Install-Package Articulate command but you'll want to let it overwrite your files in most cases so you can see what has changed and make changes accordingly.
    • Or if you want to continue using the normal Umbraco package, just install the package via the back office - do not remove the existing Articulate package first!
  • The nuget installation should do this for you but just in case this doesn't happen automatically or if you are using the Umbraco package format you'll need to update the dashboard config file, change the ArticulateImportDashboard control value to be ~/App_Plugins/Articulate/BackOffice/Dashboards/ArticulateMgmt.html
  • Probably want to commit at this point so you have a snapshot (don't commit the Articulate_Bak you just copied folder!)
  • Almost all themes have been updated, hopefully the theme you are using is a copied theme in your own folder. If so, just copy it back to the App_Plugins/Articulate/Themes folder which will now exist again. If not... you can copy the theme you were using over top of the theme folder that was installed. Then you can use source control to see what's changed. I'd say there's a 90% chance your theme will continue to 'just work' but it will be missing a bunch of new features so you'll want to merge in changes
  • Then go to the Articulate dashboard in the Developer section, go to the 'Install' tag, press Install - this will sync your current doc type's with what is updated (see the image above... same procedure for upgrades)!