- `)
* Directory features pagination
* Define custom styles inside the shortcode
* Includes lightbox support for uploaded images
* Option to __view single entries__ in their own page or in a lightbox
####Insert a totally configurable table using the editor
There are over 30 configurable options for how you want the directory to display.
###Improve Gravity Forms Functionality and Usability
* Expand the Add Fields boxes to view all the boxes at once.
* Edit form entries directly from the Entries page (saving two clicks)
* Easily access form data to use in your website with PHP functions - [Learn more on the plugin's website](http://www.seodenver.com/gravity-forms-addons/)
### Google Analytics Integration & Gravity Forms Widget
This plugin integrates Joost de Valk's Gravity Forms Widget + Extras, which includes:
* Track the referrer for the form submission using Google Analytics (adds referrer data and the search keyword[s] used to the notification emails.)
* A Gravity Forms widget (see plugin Screenshots)
#### Other Gravity Forms Add-ons:
* Gravity Forms Salesforce Add-on - Integrate Gravity Forms with Salesforce.com
* Gravity Forms Highrise Add-on - Integrate Gravity Forms with Highrise, a CRM
* Gravity Forms + Constant Contact - If you use Constant Contact and Gravity Forms, this plugin is for you.
* Gravity Forms Mad Mimi Add-on - Integrate Mad Mimi, a great email marketing company, and Gravity Forms.
* Gravity Forms ExactTarget Add-on - Integrate with ExactTarget, an enterprise-class email marketing service
#### Have an idea or issue with this Gravity Forms add-on plugin?
* [Leave suggestions, comments, and/or bug reports](http://www.seodenver.com/gravity-forms-addons/)
== Screenshots ==
1. Approving directory entries is very easy
2. When using the Form Editor, your form fields will have a Directory tab for easily modifying your display options.
3. This plugin adds an Edit link to Gravity Form entries
4. Insert a directory
5. How the Gravity Forms widget appears on the widgets page
6. The Gravity Forms Addons settings page, found in the Forms > Directory & Addons menu link
7. How the Gravity Forms 'Add Fields' boxes look after plugin is activated
== Frequently Asked Questions ==
= I want the URL to be different than `/entry/` - can I do that? =
You can! Add the following to your theme's `functions.php` file:
`
add_filter('kws_gf_directory_endpoint', 'different_directory_endpoint');
function different_directory_endpoint($endpoint) {
return 'example'; // Use your preferred text here. Note: punctuation may screw things up.
}
`
= Does this plugin require Gravity Forms? =
This plugin requires the [Gravity Forms plugin](http://wordpressformplugin.com?r=addonsfaq). __Don't use Gravity Forms? [Buy the plugin](http://wordpressformplugin.com?r=addonsfaq)__ and start using this add-on plugin!
= How do I find a field ID? =
On the Gravity Forms "Edit Forms" page, hover over the form and click the link called "IDs" that appears.
= What's the license? =
This plugin is released under a GPL license.
= Form submissions are showing as duplicates. =
This is a known issue. If the submission page has both a form in the content and the same form on the sidebar widget, the entry will be submitted twice. We're working on a fix.
= How do I remove referrer information from emails? =
Add the following to your theme's `functions.php` file:
remove_filter('gform_pre_submission_filter','gf_yst_store_referrer');
= How do I use the filters? =
If you want to modify the output of the plugin, you can do so by adding code to your active __theme's `functions.php` file__. For more information, check out the add_filter() WordPress Codex page
Plugin filters
- `kws_gf_directory_output`, `kws_gf_directory_output_'.$form_id` - Modify output for all directories or just a single directory, by ID - `kws_gf_directory_detail`, `kws_gf_directory_detail_'.$lead_id` - Modify output for single entries - `kws_gf_directory_value`, `kws_gf_directory_value_'.$input_type`, `kws_gf_directory_value_'.$field_id` - Modify output for fields in general, or based on type (`text`, `date`, `textarea`, etc...), or based on field id. - `kws_gf_directory_th`, `kws_gf_directory_th_'.$field_id`, `kws_gf_directory_th_'.sanitize_title($label)` - Modify the `
// This replaces "John" in a first name field with "Jack"
add_filter('kws_gf_directory_value_text', 'john_to_jack');
function john_to_jack($content) {
return str_replace('John', 'Jack', $content);
}
// This replaces the "Email" table column header with "asdsad"
add_filter('kws_gf_directory_th', 'email_to_asdsad');
function email_to_asdsad($content) {
return str_replace('Email', 'asdsad', $content);
}
// This replaces "Displaying 1-20" with "asdsad 1 - 20"
add_filter('kws_gf_directory_output', 'displaying_to_asdasd');
function displaying_to_asdasd($content) {
return str_replace('Displaying', 'asdsad', $content);
}
// This replaces images with the Google icon.
// You can modify all sorts of things using the $img array in this filter.
add_filter('kws_gf_directory_lead_image', 'kws_gf_directory_lead_image_edit');
function kws_gf_directory_lead_image_edit($img = array()) {
// $img = array('src' => $src, 'size' => $size, 'title' => $title, 'caption' => $caption, 'description' => $description, 'url' => $url, 'code' => "
");
$img['code'] = '
';
return $img;
}
= I can't see the fields in the Add Fields box! =
The code is meant to expand all the field boxes so you don't need to click them open and closed all the time. This works normally in Safari and Chrome (read: good browsers :-P). For some other browsers, it breaks the whole page.
To fix this issue, add this to your theme's `functions.php` file:
add_filter('kws_gf_display_all_fields', create_function('$content', 'return "";') );
== Changelog ==
= 3.0 =
* Completely revamped the admin approval process! Now approving an entry is as easy as checking a box in the Entries view.
- Supports bulk approve and un-approve
* Added "Directory Fields" in the Form Editor
- "Approved" field: Add this to your form to have a pre-configured admin-only checkbox.
- "Entry Link" field: Use this text as a link to the single entry view
* Added "Directory" tab to fields in the Form Editor
- Use Field As Link to Single Entry
- Text for Link to Single Entry
* Use field values from entry
* Use the Field Label as link text
* Use custom link text.
- Hide Field in Directory View
- Hide Field in Single Entry View
* Added a how-to video and improved instructions on settings page
* Improved how settings work & some new settings
* Added "Smart Approval" - Automatically convert directory into Approved-only mode when an Approved field is detected
* Added configuration for default directory settings on the Directory & Addons settings page
* Added `jstable` setting to enable javascript sorting using the Tablesorter script. Includes `kws_gf_directory_tablesorter_options` filter to modify Tablesorter settings.
* Updated `page_size` setting: setting a page size of 0 now shows all entries.
* Added credit link setting for directories
* Fixed bugs & issues
* Fixed search and entry counts for Approved-only directories
* Improved internationalization support
* Structural & display improvements
* Added proper enqueuing of scripts and styles with `enqueue_files` function.
* Hides search and page count when there are no results
* Restructured plugin to use the `GFDirectory` class.
* Added a host of new actions and filters to allow for inserting custom content throughout the directory
* Added support for custom endpoints (instead of `entries`...see FAQ for more information)
* And much, much more!
Note: This update has only been tested with WordPress 3.2 and Gravity Forms 1.5.2.8 and Gravity Forms 1.6 beta.
= 2.5.2 =
* Fixed broken image for lightbox close button (issue #570042)
* Fixed definition list (DL) display mode: each entry in directory view is now wrapped with a `dl`; single-entry view entries are now wrapped with single `dl`
* HTML generation fix: `- `), or definition list (`
- `)
* Added `kws_gf_directory_defaults` filter to update plugin defaults.
* Added address formatting using `appendaddress` setting. This will add a column to the output with a combined, formatted address. Use new `hideaddresspieces` setting to turn off the individual address pieces. Instead of having Street, City, State, ZIP, now there's one column "Address"
* Added `truncatelink` option (explained below)
* Added URL formatting filters to modify how links are truncated so you can choose to display the anchor text exactly as you want (the URL itself won't change). The link text `http://example.example.choicehotels.com/hotel/tx173` becomes `choicehotels.com`, but will still link to the full URL.
- Don't show http(s): `kws_gf_directory_anchor_text_striphttp`
- Strip www: `kws_gf_directory_anchor_text_stripwww`
- Show root only, not the linked to page (`example.com/inner-page/` becomes `example.com`): `kws_gf_directory_anchor_text_rootonly`
- Strip all subdomains, including www: `kws_gf_directory_anchor_text_nosubdomain`
- Hide "query strings" (`example.com?search=example&action=search` becomes `example.com`): `kws_gf_directory_anchor_text_noquerystring`
* Submit a form using the keyboard, not just clicking the button
* Added filter to change directory pagination settings (results page links): `kws_gf_results_pagination`
* Fixed issue with malformed pagination link URLs
* Improved "Expand All Menus" checkbox layout
* Discovered an issue: pagination on approved-only entries doesn't work well. To compensate, you could set your page size to a large number that contains all the entries. This likely will not be fixed soon.
= 2.4.4 =
* Added administration menu for Gravity Forms Addons, allowing you to turn off un-used or un-desired functionality. Access settings either using Forms > Addons link or Forms > Settings > Addons.
* Choose to turn off referrer information, directory functionality, the Addons widget, and Gravity Forms backend modifications
= 2.4.3 =
* Should fix issue with Approved checkbox not working in some cases where Admin-Only is enabled. Please report if still having issues.
= 2.4.2 =
* Fixed display of textarea entry data for short content (thanks, Tina)
= 2.4.1 =
* Included entry-details.php file, required for lightbox viewing
* Fixed issue with single-entry lightbox view - no longer shows admin-only columns if admin-only setting is turned off.
* Fixed Multi-blog single entry view, canonical link and chortling generation
= 2.4 =
* __Added single-entry viewing capability__
- View single entry details on either a separate page or in a lightbox
- Entries in separate page have their own permalink (http://example.com/directory/entry/[form#]/[entry#]/)
- Add entry detail links by having Entry ID column added to directory
* Fixed footer column filters
= 2.3.1 =
* Added "Expand All Menus" checkbox to easily change whether the Add Fields menus are expanded in the Form Editor
= 2.3 =
* Added new directory option: `postimage`. When your directory has an image, you can choose to show a generic icon (default) or show the full image.
* Directory entry images now have alt, width and height attributes
* Added powerful `kws_gf_directory_lead_image` filters (see "Plugin filters" in the FAQ)
= 2.2.1 =
* Added fix for Add Fields Column shifting out of view, as reported here and on the plugin support page. See the FAQ item "I can't see the fields in the Add Fields box!"
= 2.2 =
* Fixed visibility of Insert a Directory form in the admin screen
* Added multiple filters to modify output before showing the directory (See FAQ for more information)
* Since Gravity Forms 1.4 (and the advent of Ajax submission), every time someone submitted an Ajax form, admin-ajax.php would show as a visited page. This should now be fixed.
* Fixed various PHP warnings.
* Fixed lightbox functionality on links
= 2.1.2 =
* Fixed reported bug with the widget where checkboxes weren't staying checked. No other changes.
= 2.1.1 =
* Fixed "Insert Directory" modal ("lightbox") functionality (as reported on the plugin page)
= 2.1.0 =
* Incorporated Joost de Valk's Gravity Forms Widget + Extras plugin.
* Removed some code that may have been negatively affecting the display of the form fields on the Form Editor page
= 2.0.2 =
* Fixed `Warning: in_array() [function.in-array]: Wrong datatype for second argument in /gravity-forms-addons/directory.php on line 522` and
`Warning: in_array() [function.in-array]: Wrong datatype for second argument in /gravity-forms-addons/directory.php on line 528` PHP Warnings. Please note: you should turn off PHP warnings on your production website. To do this, add the following to your `wp-config.php` file:
error_reporting(0); @ini_set(Ôdisplay_errorsÕ, 0);= 2.0.1 = * Fixed Admin-only columns being shown if in Select Columns view * Turned off Admin-only columns by default, and added option to force showing of Admin-only options the Approved column will always be able to be shown. = 2.0 = * This upgrade deserves a new version number. Added directory capabilities. Killer directory capabilities. * Added a form field identifier to more easily find out the form ID. Check out the FAQ "How do I find a field ID?" = 1.2.1.1 = * Updated with GPL information. Did you know Gravity Forms is also GPL? Any WordPress plugin is. = 1.2.1 = * Fixed whitespace issue if site is gzip'ed. No need to upgrade if you aren't getting the `Warning: Cannot modify header information - headers already sent by...` PHP error. = 1.2 = * Compatibility with Gravity Forms 1.3 = 1.1 = * Added Edit link to Entries page to directly edit an entry * Added a bunch of functions to use in directly accessing form and entry data from outside the plugin = 1.0 = * Launched plugin == Upgrade Notice == = 3.0 = * Completely revamped the admin approval process! Now approving an entry is as easy as checking a box in the Entries view. - Supports bulk approve and un-approve * Added "Directory Fields" in the Form Editor - "Approved" field: Add this to your form to have a pre-configured admin-only checkbox. - "Entry Link" field: Use this text as a link to the single entry view * Added "Directory" tab to fields in the Form Editor - Use Field As Link to Single Entry - Text for Link to Single Entry * Use field values from entry * Use the Field Label as link text * Use custom link text. - Hide Field in Directory View - Hide Field in Single Entry View * Added a how-to video and improved instructions on settings page * Improved how settings work & some new settings * Added "Smart Approval" - Automatically convert directory into Approved-only mode when an Approved field is detected * Added configuration for default directory settings on the Directory & Addons settings page * Added `jstable` setting to enable javascript sorting using the Tablesorter script. Includes `kws_gf_directory_tablesorter_options` filter to modify Tablesorter settings. * Updated `page_size` setting: setting a page size of 0 now shows all entries. * Added credit link setting for directories * Fixed bugs & issues * Fixed search and entry counts for Approved-only directories * Improved internationalization support * Structural & display improvements * Added proper enqueuing of scripts and styles with `enqueue_files` function. * Hides search and page count when there are no results * Restructured plugin to use the `GFDirectory` class. * Added a host of new actions and filters to allow for inserting custom content throughout the directory * Added support for custom endpoints (instead of `entries`...see FAQ for more information) * And much, much more! Note: This update has only been tested with WordPress 3.2 and Gravity Forms 1.5.2.8 and Gravity Forms 1.6 beta. = 2.5.2 = * Fixed broken image for lightbox close button (issue #570042) * Fixed definition list (DL) display mode: each entry in directory view is now wrapped with a `dl`; single-entry view entries are now wrapped with single `dl` * HTML generation fix: `
- `), or definition list (`
- `)
* Added `kws_gf_directory_defaults` filter to update plugin defaults.
* Added address formatting using `appendaddress` setting. This will add a column to the output with a combined, formatted address. Use new `hideaddresspieces` setting to turn off the individual address pieces. Instead of having Street, City, State, ZIP, now there's one column "Address"
* Added `truncatelink` option (explained below)
* Added URL formatting filters to modify how links are truncated so you can choose to display the anchor text exactly as you want (the URL itself won't change). The link text `http://example.example.choicehotels.com/hotel/tx173` becomes `choicehotels.com`, but will still link to the full URL.
- Don't show http(s): `kws_gf_directory_anchor_text_striphttp`
- Strip www: `kws_gf_directory_anchor_text_stripwww`
- Show root only, not the linked to page (`example.com/inner-page/` becomes `example.com`): `kws_gf_directory_anchor_text_rootonly`
- Strip all subdomains, including www: `kws_gf_directory_anchor_text_nosubdomain`
- Hide "query strings" (`example.com?search=example&action=search` becomes `example.com`): `kws_gf_directory_anchor_text_noquerystring`
* Submit a form using the keyboard, not just clicking the button
* Added filter to change directory pagination settings (results page links): `kws_gf_results_pagination`
* Fixed issue with malformed pagination link URLs
* Improved "Expand All Menus" checkbox layout
* Discovered an issue: pagination on approved-only entries doesn't work well. To compensate, you could set your page size to a large number that contains all the entries. This likely will not be fixed soon.
= 2.4.4 =
* Added administration menu for Gravity Forms Addons, allowing you to turn off un-used or un-desired functionality.
= 2.4.3 =
* Should fix issue with Approved checkbox not working in some cases where Admin-Only is enabled. Please report if still having issues.
= 2.4.2 =
* Fixed display of textarea entry data for short content (thanks, Tina)
= 2.4.1 =
* Included entry-details.php file, required for lightbox viewing
* Fixed issue with single-entry lightbox view - no longer shows admin-only columns if admin-only setting is turned off.
* Fixed Multi-blog single entry view, canonical link and chortling generation
= 2.4 =
* Added single-entry viewing capability
- View single entry details on either a separate page or in a lightbox
- Entries in separate page have their own permalink (http://example.com/directory/entry/[form#]/[entry#]/)
- Add entry detail links by having Entry ID column added to directory
* Fixed footer column filters
= 2.3.1 =
* Added "Expand All Menus" checkbox to easily change whether the Add Fields menus are expanded in the Form Editor
= 2.3 =
* Added new directory option: `postimage`. When your directory has an image, you can choose to show a generic icon (default) or show the full image.
* Added powerful `kws_gf_directory_lead_image` filters (see "Plugin filters" in the FAQ)
= 2.2.1 =
* Added fix for Add Fields Column shifting out of view, as reported here and on the plugin support page. See the FAQ item "I can't see the fields in the Add Fields box!"
= 2.2 =
* Fixed visibility of Insert a Directory form in the admin screen
* Added multiple filters to modify output before showing the directory (See FAQ for more information)
* Since Gravity Forms 1.4 (and the advent of Ajax submission), every time someone submitted an Ajax form, admin-ajax.php would show as a visited page. This should now be fixed.
* Fixed various PHP warnings.
* Fixed lightbox functionality on links
= 2.1.2 =
* Fixed reported bug with the widget where checkboxes weren't staying checked. No other changes.
= 2.1.1 =
* Fixed "Insert Directory" modal ("lightbox") functionality (as reported on the plugin page)
= 2.1.0 =
* Incorporated Joost de Valk's Gravity Forms Widget + Extras plugin.
* Removed some code that may have been negatively affecting the display of the form fields on the Form Editor page.
= 2.0.2 =
* Fixed `Warning: in_array() [function.in-array]: Wrong datatype for second argument in /gravity-forms-addons/directory.php on line 522` and
`Warning: in_array() [function.in-array]: Wrong datatype for second argument in /gravity-forms-addons/directory.php on line 528` PHP Warnings. Please note: you should turn off PHP warnings on your production website. To do this, add the following to your `wp-config.php` file:
error_reporting(0); @ini_set(Ôdisplay_errorsÕ, 0);= 2.0.1 = * Fixed Admin-only columns being shown if in Select Columns view * Turned off Admin-only columns by default, and added option to force showing of Admin-only options the Approved column will always be able to be shown. = 2.0 = * This upgrade deserves a new version number. Added directory capabilities. Killer directory capabilities. == Installation == 1. Upload this plugin to your blog and Activate it 2. Using Gravity Forms, reorder the columns on the form you'd like to turn into a directory * In the "Entries: [Your Form]") screen, find the "Edit" link with the pencil icon in the table header. Click it. * Drag the columns you want in your directory onto the "Active Columns" box * Drag the columns you don't want in your directory onto the "Inactive Columns" box * Click the Save button 3. Go to the post or page where you want the directory 4. Click "Add a Gravity Forms Directory" button (likely just to the right of the Gravity Forms button) 5. Choose a form from the drop down, (you may click advanced options for lots of additional options) 6. Click "Insert Directory". A "shortcode" should appear in the content editor that looks similar to `[directory form="#"]` 7. Save the post ### Configuring Fields & Columns When editing a form, click on a field to expand the field. Next, click the "Directory" tab. There, you will find options to: * Choose whether you would like the field to be a link to the Single Entry View; * Hide the field in Directory View; and * Hide the field in Single Entry View