comfortable-mexican-sofa

• Routing is changed. Instead of ComfortableMexicanSofa::Routing.admin you have to use comfy_route :cms_admin. This new format allows wrapping all cms routes in your custom constraints or things like namespaces (although be careful with those)
• There are a number of form fields that have their data attribute changed to include cms prefix. So if before you had data-rich-text, now it's data-cms-rich-text. There was a conflict with datetime picker that required this change.

• There was slight reorganization of internals so there's a quick migration to make everything work again: https://raw.github.com/comfy/comfortable-mexican-sofa/master/db/upgrade_migrations/02_upgrade_to_1_1_0.rb. Just create a new migration, paste content of the above file and rake db:migrate.
• Some initializer settings got changed/removed. See: https://github.com/comfy/comfortable-mexican-sofa/raw/master/config/initializers/comfortable_mexican_sofa.rb
• CmsSite, CmsLayout, CmsPage, CmsSnippet are changed to Cms::Site, Cms::Layout, Cms::Page and Cms::Snippet. It only matters if you directly manipulate those objects somehow.

• Revision system is introduced and that's why you need to grab this migration: https://github.com/comfy/comfortable-mexican-sofa/raw/master/db/upgrade_migrations/03_upgrade_to_1_2_0.rb. Just create a new migration, paste content of the above file and rake db:migrate.
• New initializer setting is added revisions_limit: [[https://github.com/comfy/comfortable-mexican-sofa/raw/master/config/initializers/comfortable_mexican_sofa.rb]]

• Multiple Sites is a default functionality now. Setting to toggle it in the initializer is gone. content_prefix_path is an attribute of the Site now. This way if you want to serve pages from http://localhost/en/ you need to set up a Site with hostname localhost and path en.
• Migration file can be found here: https://github.com/comfy/comfortable-mexican-sofa/raw/master/db/upgrade_migrations/04_upgrade_to_1_3_0.rb
• Page caching (along with the initializer setting) is removed for the time being as it doesn't work for multiple sites.

• You can manage your uploads from the dedicated Files section. It will even allow you to upload multiple files at the same time.
• Pages, snippets and files can be categorized. Helps with management and allows you to pull collections like this: @site.files.for_category('red_category', 'blue_category')
• Don't forget to apply the migration https://github.com/comfy/comfortable-mexican-sofa/raw/master/db/upgrade_migrations/05_upgrade_to_1_4_0.rb
• There are some CSS and JS changes as well, so run rails g comfy:cms if running Rails 3.0

• Introducing Collection and PageFile(s) tags.
• Reordering functionality for Layouts, Snippets and Files.
• As always migration is needed: https://raw.github.com/comfy/comfortable-mexican-sofa/master/db/upgrade_migrations/06_upgrade_to_1_5_0.rb
• Rails 3.0 users please run rails g comfy:cms to refresh CSS.

• Replaced Wymeditor with elRTE.
• Integrated image insertion with uploaded files.
• Categories are scoped on Sites.
• Cleaned up mess with slugs/labels. Now if your find_by_slug method is failing you want to replace it with find_by_identifier. Sites have identifiers now too.
• Bumped up paperclip version in the Gemfile. Anything above 2.3.0 is OK. Choose your version wisely.
• Migration file: https://raw.github.com/comfy/comfortable-mexican-sofa/master/db/upgrade_migrations/07_upgrade_to_1_6_0.rb
• Don't forget to rails g comfy:cms if not using asset pipeline.
• You also might need to refresh thumbnails for previously uploaded images with: rake paperclip:refresh CLASS=Cms::File

• Discovered a crappy paperclip default that now corrected with config.upload_file_options. Now default attachment url is set to /system/:class/:id/:attachment/:style/:filename instead of /system/:attachment/:id/:style/:filename. This means you'll need to move directories to adjust for this change. Not a problem if you never uploaded any files through CMS, or have your own override in place.

• Fixture importing/exporting uses site identifiers instead of hostnames. You may need to adjust folder names.

• Admin interface is styled using Bootstrap 2.3.0
• Forms are handled with formatted_form
• Upgraded to CodeMirror 3
• Bumped up Paperclip version requirement to 3.4.0. Default config is fixed now.
• Replaced elRTE wysiwyg editor with wysihtml5
• Due to wysiwyg editor replacement file insertion and management is temporarily missing.
• Added support for Markdown. You can define markdown fields like this: {{ cms:page:content:markdown }}
• Added support for Ruby 2.0.0
• Dropped support for Ruby 1.8.7
• Dropped support for Rails 3.0 (upgrade to 3.1 or 3.2)
• Introduced a few common dependencies. HAML/SASS replace HTML/CSS. CoffeeScript will replace JS scripts.
• No new migrations to worry about.

• Routing is now explicit. No more hoping that the globbing content serving route attaches itself at the bottom. Now you have to specify where routes go. All you need to do it either run rails g comfy:cms and move newly created routes (they'll probably end up at the top of the file), or manually paste this at the bottom of your routes.rb: ComfortableMexicanSofa::Routing.content :path => '/', :sitemap => false. You should also add this, if you want to access admin area: ComfortableMexicanSofa::Routing.admin :path => '/cms-admin'
• Added extra manifests for easy admin area customization. If you want to change css within admin area, simply create app/assets/stylesheets/comfortable_mexican_sofa/admin/application.css (.sass/.scss/.whatever). For javascript, same idea: app/assets/javascripts/comfortable_mexican_sofa/admin/application.js (.coffee?).

• Restructured internal folder structure and routes. Shouldn't affect your app unless you done some monkey patching. Should be very easy to fix if something's broken.
• Codemirror assets are managed via a gem. No longer frozen inside cms assets.
• Kaminari is shipped with the gem in case you need to do some pagination.
• Your public controllers can inherit from Cms::BaseController if you want to automatically load @cms_site
• Similarly, admin base controller is now named Admin::Cms::BaseController
• You can quickly generate admin area scaffold. For example: rails g comfy:scaffold User email:string full_name:string. This will create a model, controller, views, routes and even tests.
• Now it's possible to use HAML instead of HTML in cms fixtures. This works for layouts, pages and snippets. Leave .html file extension alone, just write content in HAML

• Can change controller that cms admin controller inherits from. Default is ApplicationController but if you don't want before_filters kicking in you may create your own controller and use that. See: config.base_controller inside initializer.

• Caching of page content changed. Now page.content is created on access. No need to recompute it for all pages when related content changes. This change should speed things up especially on sites with tons of content.
• You don't need to use ViewHooks to add partials to admin views. I added a pile of partials that you can override: list of partials In order to see what's available and where enable this setting: config.reveal_cms_partials
• A pile of small fixes

• No functional changes from last 1.8 version. Making everything work in Rails 4 environment.
• As of this version Rails 3 is no longer supported. 1.8.* might get backported updates if requested.

CMS Fixtures import/export functionality is completely rewritten. Notable (and potentially breaking) changes:

• Page attributes are stored in a attributes.yml file instead of _{page_slug}.yml
• Same applies to layouts and snippets.
• Page fixtures properly assign target_page attribute
• It's possible to define categories for pages and snippets in the attributes.yml
• Categories can be imported/exported. Even the ones that are not currently used.
• Files can be imported/exported as well.
• Rake task will 'force' import everything. Meaning it's not going to be checking for freshness of the data.
• Files require to have unique filenames for a given Site.

See example fixture files for structure reference. Run rails g comfy:cms to update them.