fae-rails 1.2.4 → 1.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 844f9b86957a5b0d3e581b4c6bc087e707836ca3
-  data.tar.gz: e03e475052ef1ef0c565762e120db9ca8d7b03a1
+  metadata.gz: 9b0803f3934f29d530c5c6d7ffbd35433510ed5f
+  data.tar.gz: 01bfa00c5552d3d92f9c1299fd0bbce9474f5361
 SHA512:
-  metadata.gz: c4c5f1ee759f3d665f8927415b025f02e0020ff55d68a83739aa5536f1ebe90d95aed351036247d668eca3e1c8b94933ab48a2072a3c839a4ec779e345f8ad04
-  data.tar.gz: ea1fdb98e4f77995e7b778f21e0f6faa65815f776d72a94d95ae568b73df3aa5ea6b73bc115b26b2c70523ceef35eea3138c7393710789eaeff845fd06b0a18f
+  metadata.gz: 9e968a29aa7b8aa0ae4fa8adc70be36f15f98c3099dc3a7692375992c2f3e172bd50182443dc2aab987957ea3af72a4da905586902a3eabae62c732758e13570
+  data.tar.gz: 68bb793b7ba4b9d6f0e6a719a7db4168f10bb1247054f76bdb4e4aa3d9c18ff535f44fe480506dcb22e0a164961b5089d774473c1686fff68dcf8eb310ce0e37

data/README.md

@@ -1,7 +1,8 @@
 # Meet Fae
 
-![Shippable Status](https://img.shields.io/shippable/5522ec125ab6cc1352b9bb77.svg)
+[![Build Status](https://travis-ci.org/wearefine/fae.svg?branch=master)](https://travis-ci.org/wearefine/fae)
 [![Code Climate](https://codeclimate.com/github/wearefine/fae/badges/gpa.svg)](https://codeclimate.com/github/wearefine/fae)
+![Shippable Status](https://img.shields.io/shippable/5522ec125ab6cc1352b9bb77.svg)
 
 Fae is CMS for Rails unlike any other. Like most Rails CMS engines, Fae provides all the basics to get you up and running: authentication, a responsive UI, form element and workflows. But unlike other CMS engines, Fae's methodology is based around generators and a DSL over configuration. This allows you to get to a working CMS very quickly, but gives you the flexibility to customize any piece you need.
 

data/app/assets/javascripts/fae/application.js

@@ -29,7 +29,7 @@
 //= require underscore
 //= require json2
 //= require judge
-//= require grinder
+//= require fryr
 //= require simplemde.min
 
 //= require fae/judge_path
@@ -43,6 +43,7 @@
 //= require fae/form/inputs/_select
 //= require fae/form/inputs/_text
 //= require fae/form/inputs/_checkbox
+//= require fae/form/_slugger
 //= require fae/form/_validator
 //= require fae/form/_cancel
 //= require fae/form/_ajax

data/app/assets/javascripts/fae/form/_ajax.js

@@ -20,12 +20,13 @@ Fae.form.ajax = {
 
     this.imageDeleteLinks();
     this.htmlListeners();
-    this.applyCookies();
 
     this.deleteNoForm();
 
-    // Re-applied once AJAX form is loaded in
     if (this.$filter_form.length) {
+      this.applyCookies();
+
+      // These are also re-applied once AJAX form is loaded in
       this.filterSelect();
       this.filterSubmission();
     }
@@ -78,7 +79,7 @@ Fae.form.ajax = {
       // Reinitialize form elements
       Fae.form.dates.initDatepicker();
       Fae.form.dates.initDateRangePicker();
-      Fae.form.text.slugger();
+      Fae.form.slugger.addListener();
       Fae.form.validator.length_counter.init();
       Fae.form.text.initMarkdown();
       Fae.form.checkbox.setCheckboxAsActive();
@@ -228,10 +229,11 @@ Fae.form.ajax = {
   applyCookies: function() {
     var cookie_key = $('.js-filter-form').attr('data-cookie-key');
 
-    this.grind = new Grinder(this._setFilterDropdowns);
+    this.fry = new Fryr(this._setFilterDropdowns);
 
     if (cookie_key) {
       var cookie = Cookies.getJSON(cookie_key);
+
       if (!$.isEmptyObject(cookie)) {
         var keys = Object.keys(cookie)
         var hash = '?';
@@ -260,39 +262,40 @@ Fae.form.ajax = {
         var key = $(this).find('select').attr('id').split('filter_')[1];
         var value = $(this).find('option:selected').val();
 
-        _this.grind.update(key, value, false, true);
+        _this.fry.update(key, value);
       }
     });
   },
 
   /**
-   * Check for cookie or hash and set dropdowns/ url accordingly (callback for Grinder)
-   * @param {Object} params - hash params broken out from Grinder
+   * Check for cookie or hash and set dropdowns/ url accordingly (callback for Fryr)
+   * @param {Object} params - hash params broken out from Fryr
    */
   _setFilterDropdowns: function(params) {
     var cookie_name = $('.js-filter-form').attr('data-cookie-key');
     Cookies.set(cookie_name, params);
 
-    if (!$.isEmptyObject(params)) {
-      $.each(params, function(k, v) {
-        $('.js-filter-form .table-filter-group').each(function(){
-          var $this = $(this);
-          var key = $this.find('select').attr('id').split('filter_')[1];
-          var value = $this.find('option:selected').val();
-
-          if (k === key) {
-            $this.find('option').each(function(){
-              if ($this.val() === v) {
-                $this.prop('selected', 'selected');
-                $('#filter_' + key).trigger('chosen:updated');
-              };
-            });
-          }
-        });
-      });
-
-      $('.js-filter-form').submit();
+    // Exit early if params is blank
+    if ($.isEmptyObject(params)) {
+      return;
     }
+
+    // Loop through all available params to find the select menu and the proper option
+    $.each(params, function(key, value) {
+      var $select = $('.js-filter-form .table-filter-group #filter_' + key);
+
+      if($select.length) {
+        var $option = $select.find('option[value="' + value + '"]');
+
+        // Ensure we find the option and that it isn't already chosen
+        if($option.length && $option.prop('selected') !== 'selected') {
+          $option.prop('selected', 'selected');
+          $select.trigger('chosen:updated');
+        }
+      }
+    });
+
+    $('.js-filter-form').submit();
   },
 
   /**

data/app/assets/javascripts/fae/form/_form.js

@@ -16,6 +16,7 @@ Fae.form = {
     this.validator.init();
     this.cancel.init();
     this.ajax.init();
+    this.slugger.init();
 
     // input type=file customization
     // This doesn't work in IE. It's not worth figuring out why by this point. IE9 gets plain file uploader.

data/app/assets/javascripts/fae/form/_slugger.js.erb

@@ -0,0 +1,100 @@
+/* global Fae */
+
+'use strict';
+
+/**
+ * Fae form
+ * @namespace form
+ * @memberof Fae
+ */
+Fae.form.slugger = {
+  init: function() {
+    this.addListener();
+  },
+
+  /**
+   * Attach listeners to inputs and update slug fields with original safe values from the original inputs
+   */
+  addListener: function() {
+    var _this = this;
+
+    $('.slug').each(function() {
+      var $form = $(this).closest('form');
+      var $sluggers = $form.find('.slugger');
+      var $slug = $form.find('.slug');
+      var $select_slugger = $('.select.slugger');
+
+      if ($slug.val() !== '') {
+        $sluggers.removeClass('slugger');
+
+      } else {
+        // If it's a text field, listen for type input
+        $sluggers.keyup(function(){
+          var text = _this._digestSlug( $sluggers );
+          $slug.val( text );
+        });
+
+        // If it's a select field, listen for the change
+        if ($select_slugger.length) {
+          $select_slugger.change(function(){
+            var text = _this._digestSlug( $sluggers );
+            $slug.val( text );
+          });
+
+        };
+      }
+    });
+  },
+
+  /**
+   * Convert a group of selects or text fields into one slug string
+   * @access protected
+   * @param {jQuery} $sluggers - Input or inputs that should be converted into a URL-safe string
+   * @return {String}
+   */
+  _digestSlug: function($sluggers) {
+    var slug_text = []
+
+    $sluggers.each(function() {
+      var $this = $(this);
+
+      if ($this.val().length) {
+
+        if ($this.is('input')) {
+          slug_text.push( $this.val() );
+
+        } else {
+          slug_text.push( $this.find('option:selected').text() );
+
+        }
+      }
+    });
+
+    // Combine all active slug fields for the query
+    slug_text = slug_text.join(' ');
+
+    // Strip accented characters
+    var from = 'àáâãäæåçèéêëęēėìíîïñòóôõöùúûüýÿÀÁÂÃÄÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝ';
+    var to = 'aaaaaaaceeeeeeeiiiinooooouuuuyyAAAAACEEEEIIIINOOOOOUUUUY';
+
+    // Loop through all accented characters and replace with non-accents
+    for (var i = 0; i < from.length; i++) {
+      slug_text = slug_text.replace( new RegExp(from.charAt(i), 'g'), to.charAt(i) );
+    }
+
+    // Remove leading and trailing spaces
+    // Make them lowercase
+    // Remove slashes, quotes or periods
+    // Replace white spaces with a Fae.slug_separator
+    // Remove leading and trailing dashes
+    slug_text = slug_text
+      .trim()
+      .toLowerCase()
+      .replace(/[^<%= Fae.slug_separator %>\w\s]/g, '')
+      .replace(/[<%= Fae.slug_separator %>\s]+/g, '<%= Fae.slug_separator %>')
+      .replace(/(^<%= Fae.slug_separator %>)|(<%= Fae.slug_separator %>$)/g, '');
+
+    return slug_text;
+  }
+
+};

data/app/assets/javascripts/fae/form/inputs/_text.js

@@ -10,96 +10,10 @@
 Fae.form.text = {
 
   init: function() {
-    this.slugger();
     this.overrideMarkdownDefaults();
     this.initMarkdown();
   },
 
-  /**
-   * Attach listeners to inputs and update slug fields with original safe values from the original inputs
-   */
-  slugger: function() {
-    var _this = this;
-
-    $('.slug').each(function() {
-      var $form = $(this).closest('form');
-      var $sluggers = $form.find('.slugger');
-      var $slug = $form.find('.slug');
-      var $select_slugger = $('.select.slugger');
-
-      if ($slug.val() !== '') {
-        $sluggers.removeClass('slugger');
-
-      } else {
-        // If it's a text field, listen for type input
-        $sluggers.keyup(function(){
-          var text = _this._digestSlug( $sluggers );
-          $slug.val( text );
-        });
-
-        // If it's a select field, listen for the change
-        if ($select_slugger.length) {
-          $select_slugger.change(function(){
-            var text = _this._digestSlug( $sluggers );
-            $slug.val( text );
-          });
-
-        };
-      }
-    });
-  },
-
-  /**
-   * Convert a group of selects or text fields into one slug string
-   * @access protected
-   * @param {jQuery} $sluggers - Input or inputs that should be converted into a URL-safe string
-   * @return {String}
-   */
-  _digestSlug: function($sluggers) {
-    var slug_text = []
-
-    $sluggers.each(function() {
-      var $this = $(this);
-
-      if ($this.val().length) {
-
-        if ($this.is('input')) {
-          slug_text.push( $this.val() );
-
-        } else {
-          slug_text.push( $this.find('option:selected').text() );
-
-        }
-      }
-    });
-
-    // Combine all active slug fields for the query
-    slug_text = slug_text.join(' ');
-
-    // Strip accented characters
-    var from = 'àáâãäæåçèéêëęēėìíîïñòóôõöùúûüýÿÀÁÂÃÄÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝ';
-    var to = 'aaaaaaaceeeeeeeiiiinooooouuuuyyAAAAACEEEEIIIINOOOOOUUUUY';
-
-    // Loop through all accented characters and replace with non-accents
-    for (var i = 0; i < from.length; i++) {
-      slug_text = slug_text.replace( new RegExp(from.charAt(i), 'g'), to.charAt(i) );
-    }
-
-    // Remove leading and trailing spaces
-    // Make them lowercase
-    // Remove slashes, quotes or periods
-    // Replace white spaces with a dash
-    // Remove leading and trailing dashes
-    slug_text = slug_text
-      .trim()
-      .toLowerCase()
-      .replace(/[^-\w\s]/g, '')
-      .replace(/[-\s]+/g, '-')
-      .replace(/(^-)|(-$)/g, '');
-
-    return slug_text;
-  },
-
   /**
    * Override SimpleMDE's preference for font-awesome icons and use a modal for the guide
    * @see {@link modals.markdownModal}

data/app/controllers/fae/images_controller.rb

@@ -27,6 +27,7 @@ module Fae
       image = Image.find_by_id(params[:id])
       image.remove_asset = true
       image.save
+      CarrierWave.clean_cached_files!
       render :nothing => true
     end
 

data/app/controllers/fae/setup_controller.rb

@@ -1,6 +1,7 @@
 module Fae
   class SetupController < ActionController::Base
 
+    before_action :check_roles
     layout 'devise'
 
     def first_user
@@ -35,5 +36,10 @@ module Fae
       params.require(:user).permit(:email, :first_name, :last_name, :password, :password_confirmation)
     end
 
+    def check_roles 
+      if Fae::Role.all.empty?
+        raise "Role 'super admin' does not exist in Fae::Role, run rake fae:seed_db"
+      end
+    end
   end
 end

data/app/helpers/fae/application_helper.rb

@@ -98,7 +98,9 @@ module Fae
       if change.changeable_type.exclude?('Fae') && change.changeable_type.exclude?('Page') && (!ActiveRecord::Base.connection.table_exists? change.changeable_type.tableize)
         return "#{change.changeable_type}: model destroyed"
       else
-        text += change.try(:changeable).try(:fae_display_field) || "##{change.changeable_id}"
+        display_text = change.try(:changeable).try(:fae_display_field)
+        display_text = (display_text.is_a? Integer) ? display_text.to_s : display_text
+        text += display_text || "##{change.changeable_id}"
 
         begin
           return link_to text, fae.edit_content_block_path(change.changeable.slug) if change.changeable_type == 'Fae::StaticPage'

data/app/views/fae/shared/_nested_table.html.slim

@@ -23,6 +23,17 @@ ruby:
   new_path            ||= "new_#{fae_path}_#{assoc_name_singular}_path"
   edit_path           ||= "edit_#{fae_path}_#{assoc_name_singular}_path"
 
+  begin
+    if index
+      new_path = self.send(new_path)
+    else
+      new_path = self.send(new_path, item_id: parent_item.id, item_class: parent_item.class.to_s)
+    end
+  rescue
+    new_path += new_path['?'] ? '&' : '?'
+    new_path += "item_id=#{parent_item.id}&=item_class=#{parent_item.class.to_s}"
+  end
+
   options_for_table = { index: index, assoc: assoc, assoc_name: assoc_name, title: title, header: header, add_button_text: add_button_text, ordered: ordered, has_thumb: has_thumb, edit_column: edit_column, cols: cols, assoc_name_singular: assoc_name_singular, new_path: new_path, edit_path: edit_path }
   options_for_table[:parent_item] = parent_item unless index
 
@@ -35,7 +46,7 @@ ruby:
   h2.main_content-section-title = header
   .main_content-section-area
     section.js-addedit-form
-      a.js-add-link.table-add-link href=self.send(new_path, item_id: parent_item.id, item_class: parent_item.class.to_s) = add_button_text
+      a.js-add-link.table-add-link href=new_path = add_button_text
       h3 = title
       - if helper_text.present?
         h6.table-helper-text = helper_text

data/app/views/fae/shared/_shared_nested_table.html.slim

@@ -43,10 +43,7 @@ table class=table_class
             = link_to '', "/#{fae_path}/#{assoc_name}/#{item.id.to_s}", method: :delete, defaults: { confirm: t('fae.delete_confirmation') }, class: 'js-delete-link icon-delete_x', remote: true
     - else
       tr
-        - if index
-          - td_link = link_to "add some", self.send(new_path), class: 'js-add-link'
-        - else
-          - td_link = link_to "add some", self.send(new_path, item_id: parent_item.id, item_class: parent_item.class.to_s), class: 'js-add-link'
+        - td_link = link_to "add some", new_path, class: 'js-add-link'
 
         td colspan=colspan.to_s == "No #{title} yet, #{td_link}."
 

data/config/initializers/carrierwave.rb

@@ -0,0 +1,3 @@
+ CarrierWave.configure do |config|
+    config.cache_dir = "#{Rails.root}/tmp/fae/uploads"
+ end

data/docs/helpers.md

@@ -10,7 +10,7 @@
 
 # Form Helpers
 
-Form helpers in Fae use the [simple_form](https://github.com/plataformatec/simple_form) gem as it's base. In most cases options that simple_form accepts can be passed into these helpers directly. The reason why we've established these helpers it to allow for customized options. They also provide a method to directly hook into Fae, so we can push out features and bugfixes.
+Form helpers in Fae use the [simple_form](https://github.com/plataformatec/simple_form) gem as its base. In most cases, options that simple_form accepts can be passed into these helpers directly. The reason we have established these helpers is to allow for customized options. They also provide a method to directly hook into Fae, so we can push out features and bugfixes.
 
 ## Format
 
@@ -22,7 +22,7 @@ fae_method_name(f, attribute, options)
 
 | argument | description |
 | -------- | ----------- |
-| f | **(required)** The variable simple_form passes through in it's block. The actual variable can vary based on how you setup the view, but `f` is the generated default. |
+| f | **(required)** The variable simple_form passes through in its block. The actual variable can vary based on how you setup the view, but `f` is the generated default. |
 | attribute | **(required)** The attribute the form element is displaying. It's recommended you use symbols over strings. |
 | options | An optional hash of options to customize the form element. |
 
@@ -55,7 +55,7 @@ An input[type=text] with an added wrapper_class and helper_text:
 fae_input f, :first_name, wrapper_class: 'special_wrapper', helper_text: 'No more than 50 characters'
 ```
 
-A textarea with Fae's built-in markdown hint:
+A text area with Fae's built-in markdown hint:
 ```ruby
 fae_input f, :description, markdown_supported: true
 ```
@@ -134,7 +134,7 @@ fae_pulldown f, :wine, size: 'short', collection: Wine.order(:name)
 
 | option | type | default | description |
 | ------ | ---- | ------- | ----------- |
-| two_pane | boolean | false | By default this will display a chosen style multiselect, setting this to true will display the 'two pane' style. |
+| two_pane | boolean | false | By default this will display a chosen style multiselect. Setting this to true will display the 'two pane' style. |
 
 **Examples**
 
@@ -184,7 +184,7 @@ fae_daterange f, [:start_date, :end_date], label: 'Start/End dates'
 
 | option | type | default | description |
 | ------ | ---- | ------- | ----------- |
-| prefix | string | | **(required)** string to appear in prefix box |
+| prefix | string | | **(required)** string will appear in prefix box |
 | icon | boolean | false | determines whether or not to display prefix icon |
 
 **Examples**
@@ -199,7 +199,7 @@ fae_prefix f, :price, prefix: '$', placeholder: '50.00'
 
 | option | type | default | description |
 | ------ | ---- | ------- | ----------- |
-| suffix | string | | **(required)** string to appear in suffix box |
+| suffix | string | | **(required)** string will appear in suffix box |
 | icon | boolean | false | determines whether or not to display prefix icon |
 
 **Examples**
@@ -236,8 +236,8 @@ fae_video_url f, :video_url
 | alt_helper_text     | string | | the alt field's helper text |
 | caption_label       | string | "#{image_label} caption" | the caption field's label |
 | caption_helper_text | string | | the caption field's helper text |
-| show_alt            | boolean | true | displays the alt field, label and helper text |
-| show_caption        | boolean | false | displays the caption field, label and helper text |
+| show_alt            | boolean | true | displays the alt field, label, and helper text |
+| show_caption        | boolean | false | displays the caption field, label, and helper text |
 | required            | boolean | false | adds required validation to the uploader |
 | attached_as         | symbol | image_name.to_s | Sets the `attached_as` atrribute on upload. You'll need to customize this if your `attached_as` condition doesn't match the images associaiton name. |
 
@@ -277,7 +277,7 @@ fae_file_form f, :tasting_notes_pdf, helper_text: 'PDF format only'
 | hint          | string | | the field's hint text (supports HTML) |
 | markdown      | boolean | false | adds markdown GUI toolbar |
 | markdown_supported | boolean | false | displays support text and hint for markdown |
-| input_options | hash with simple form options | false | adds simple form options to input field |
+| input_options | hash with simple form options | false | adds simple form options to the input field |
 
 image_label: nil, alt_label: nil, caption_label: nil, omit: nil, show_thumb: nil, required: nil, helper_text: nil, alt_helper_text: nil, caption_helper_text: nil, wrapper_html: nil, input_options: nil
 
@@ -293,14 +293,14 @@ fae_content_form f, :ad, input_options: { collection: ['Header', 'Footer'], inpu
 
 ## fae_filter_form
 
-Displays the filter form, including the search field, submit and reset buttons. Accepts options and a block.
+Displays the filter form, which includes the search field, submit, and reset buttons. It accepts options and a block.
 
 | option | type    | default                                | description |
 |--------|---------|----------------------------------------|-------------|
 | action | string  | "#{@index_path}/filter" | the path the form submits to |
 | title  | string  | "Search #{@klass_humanized.pluralize}" | the h2 text in the filter form |
 | search | boolean | true                                   | displays the search field |
-| cookie_key | string | false | set your cookie name on the fae_filter_form if you want to persist selected filtered state |
+| cookie_key | string | false | set your cookie name on the fae_filter_form if you want to persist the selected filtered state |
 
 
 **Examples**
@@ -320,7 +320,7 @@ Dislays a select tag to be used within a `fae_filter_form`.
 | label        | string                  | attribute.to_s.titleize        | label on select |
 | collection   | ActiveRecord collection | AttributeAsClass.for_fae_index | the collection of AR objects to populate the select options |
 | label_method | symbol                  | :fae_display_field             | the attribute to use as the label in the select options |
-| placeholder  | string or boolean       | "All #{options[:label]}"       | the blank value in the select, can be set to false to disable |
+| placeholder  | string or boolean       | "All #{options[:label]}"       | the blank value in the select. It can be set to false to disable |
 | options      | array                   | []                             | an alternative array of options if the options aren't an ActiveRecord collection |
 | grouped_options | array                | []                             | an alternative array of grouped options if the options aren't an ActiveRecord collection |
 | grouped_by   | symbol                  |                                | a Fae association on the models in `collection`. The association must have a `fae_display_name` method |
@@ -340,7 +340,7 @@ Dislays a select tag to be used within a `fae_filter_form`.
 ## fae_date_format
 
 The fae_date_format and fae_datetime_format helpers format a DateTime object in Fae's preferred method.
-The default, fae_date_format, formats to 06/23/15.
+The default fae_date_format formats to: 06/23/15.
 
 ```ruby
 fae_date_format item.updated_at
@@ -348,7 +348,7 @@ fae_date_format item.updated_at
 
 ## fae_datetime_format
 
-You may also use fae_datetime_format for the long date format with time (Jun 23, 2015  4:56pm PDT).
+You can also use fae_datetime_format for the long date format with the timestamp: Jun 23, 2015  4:56pm PDT.
 
 ```ruby
 fae_datetime_format item.updated_at
@@ -388,9 +388,9 @@ renders `<h1>New Release</h1>` on the new page
 
 ## require_locals
 
-The require_locals method is intended to be used at the beginning of any partial that pulls in a local variable from the page that renders it. It takes a Array of strings containing the variables that are required and the local_assigns view helper method.
+The require_locals method is intended to be used at the beginning of any partial that pulls in a local variable from the page that renders it. It takes an Array of strings containing the variables that are required and the local_assigns view helper method.
 
-If one of the locals aren't set when the partial is called and error will be raised with an informative message.
+If one of the locals aren't set when the partial is called, an error will be raised with an informative message.
 
 ```ruby
 require_locals ['item', 'text'], local_assigns
@@ -402,7 +402,7 @@ require_locals ['item', 'text'], local_assigns
 
 ## index_header
 
-Displays page title, add button and flash messages.
+Displays page title, add button, and flash messages.
 
 | option | type | default | description |
 |-|-|-|-|
@@ -465,22 +465,23 @@ render 'fae/shared/form_buttons', save_button_text: 'Yes!', cancel_button_text:
 
 The nested table works in tandem with a nested model, typically created by the nested scaffold generator, to display a nested ajax form for creating associated items in the edit form.
 
-The nested_table should go after the main form ends and should only placed on the edit page (it requires the parent_item to be present to associate new items to).
+The nested_table should go after the main form ends and should only be placed on the edit page (it requires the parent_item to be present to associate new items to).
 
 | option | type | default | description |
 |--------|------|---------|-------------|
 | index | false | boolean | used for nested index forms |
 | assoc   | symbol | | **(required)** the association's name, or the item's name if it's for the index  |
-| parent_item | ActiveRecord object | | **(required)** the item the new objects will be associated to  |
-| cols | array of symbols | [] | an array of attributes to display on the list view, associations will display the `fae_display_field` or a thumbnail if it's a `Fae::Image` |
+| parent_item | ActiveRecord object | | **(required)** the item that the new objects will be associated to  |
+| cols | array of symbols | [] | an array of attributes to display on the list view. Associations will display the `fae_display_field` or a thumbnail if it's a `Fae::Image` |
 | title | string | assoc.to_s.humanize | the H3 directly above the form |
 | header | string | title | the section's header |
 | add_button_text | string | "Add #{title.singularize}" | the add button's text |
-| ordered | boolean | false | allows list view to be sortable, which is saved to a `position` atttribute |
+| ordered | boolean | false | allows list view to be sortable, which is saved to a `position` attribute |
 | has_thumb | boolean | false | displays a thumbnail in the list view (only applicable to `Fae::Image`)
 | edit_column | boolean | false | displays edit link
-| assoc_name | string | assoc.to_s | the stringified association name, used in the paths, **only update if you know what you're doing** |
-| helper_text | string | '' | the h6 directly above the nested table, and below the tite,used to provide the user with some helper_text to describe the context |
+| assoc_name | string | assoc.to_s | the stringified association name, which is used in the paths. **only update if you know what you're doing** |
+| helper_text | string | '' | the h6 directly above the nested table and below the tite, which is used to provide the user with some helper_text to describe the context |
+| new_path | string | "new_#{fae_path}_#{assoc_name_singular}_path" | the path that the application will hit when creating a new object inside the nested table, which is used to provide the user with the ability to pass in some params |
 
 
 **Examples**
@@ -493,12 +494,13 @@ Full Slim implementation with section wrapper and edit page conditional
       assoc: :tasting_notes,
       parent_item: @item,
       cols: [:name, :author, :live],
-      ordered: true
+      ordered: true,
+      new_path: "/admin/winemakers/new?region_type=#{region_type}"
 ```
 
 ## recent_changes
 
-Displays recent changes to an object as logged by [Fae's change tracker](usage.md#markdown-header-change-tracker) in a table. Columns include the change's user, type, updated attributes and datetime.
+Displays recent changes to an object as logged by [Fae's change tracker](usage.md#markdown-header-change-tracker) in a table. Columns include the user, type, updated attributes, and datetime of the change.
 
 This partial is best placed at the bottom of the form and will automatically hide itself in create forms, where there wouldn't be changes to display.
 
@@ -531,3 +533,17 @@ Auto-generate a slug from a field. Only populates if the `slug` input is blank.
 = fae_input f, :name, input_class: 'slugger'
 = fae_input f, :slug, helper_text: 'Populated from name'
 ```
+
+### Custom slug separator
+
+By default, Fae's slugger used dashes to separate words in the formatted string. However, you can customize this with the following option in `config/initializers/fae.rb`:
+
+```ruby
+Fae.setup do |config|
+
+  config.slug_separator = '_'
+
+end
+```
+
+Note: `slug_separator` is used in a regex to format the string. Certain characters (e.g. `+`) can break the regex, so if slugger stops working after you update this option check the errors in the console to see why.