Skip to content

Latest commit

 

History

History
80 lines (60 loc) · 2.33 KB

index.md

File metadata and controls

80 lines (60 loc) · 2.33 KB

Upgrading Fae

To v1.5

has_top_nav has been deprecated. Any admin still using side nav only will convert to using the top nav upon upgrade without any changes necessary.

From v1.2 to v1.3

Fae v1.3 has a new layout featuring a horizontal navigation across the top of the app. After updating, you may chose to enable the top nav or not.

If you choose to enable top nav, you need to do the following:

In config/initializers/fae.rb, uncomment

config.has_top_nav = true

You will also need to remove the existing controllers/concerns/fae/nav_items file, and add the new file to models/concerns/fae/navigation_concern.rb

navigation_concern.rb file contents

module Fae
  module NavigationConcern
    extend ActiveSupport::Concern

    # define the navigation structure in this file
    # navigation will default to the sidenav,
    # unless you set the following in the Fae initializer:
    #
    #   config.has_top_nav = true

    # example  structure with top nav:
    #
    # def structure
    #   [
    #     item('Top Nav Item 1', subitems: [
    #       item('Top Nav Dropdown Item 1', class: 'custom-class', path: some_named_route_path),
    #       item('Top Nav Dropdown Item 2', subitems: [
    #         item('Side Nav Item 1', subitems: [
    #           item('Side Nav Nested Item', path: some_named_route_path)
    #         ]),
    #         item('Side Nav Item 1', path: some_named_route_path)
    #       ]),
    #     ]),
    #     item('Pages', subitems: [
    #       item('Home', path: fae.edit_content_block_path('home')),
    #       item('About Us', path: fae.edit_content_block_path('about_us'))
    #     ])
    #   ]
    # end
  end
end

If you want the top level item for nav items with nested links to go to a specific path, pass in path: some_named_route_path to the top level after the name string, otherwise it will default to the first item in the list.

# def structure
#   [
#     item('Top Nav Item 1', path: some_named_route_path, subitems: [
#       ...

From v1.1 to v1.2

Fae v1.2 adds a new table Fae::Change to track changes on your objects. After updating you'll have to copy over and run the new migrations.

$ rake fae:install:migrations
$ rake db:migrate