Gravity Forms Toolbar

1. 

   Gravity Forms Toolbar in default state. (Click here for larger version of screenshot)

2. 

   Gravity Forms Toolbar in action - a secondary level - form management. (Click here for larger version of screenshot)

3. 

   Gravity Forms Toolbar in action - a third level, for the official (and some third-party) Add-Ons. ([https://www.dropbox.com/s/2zlvbaxw8mbat88/screenshot-3.png))

4. 

   Gravity Forms Toolbar in action - a secondary level - docs. (Click here for larger version of screenshot)

5. 

   Gravity Forms Toolbar in action - a primary level - notification of new entries & updates. (Click here for larger version of screenshot)

6. 

   Gravity Forms Toolbar in action - notification of new entries & updates on top-level. (Click here for larger version of screenshot)

7. 

   Gravity Forms Toolbar - little admin settings page of the plugin.(Click here for larger version of screenshot)

8. 

   Gravity Forms Toolbar - help tab on admin settings page of the plugin. (Click here for larger version of screenshot)

Does this plugin work with newest WP version and also older versions?

Yes, this plugin works really fine with WordPress 3.3 and 3.3.1!
It also works great with WP 3.2 – and also should with WP 3.1 – but we only tested extensively with WP 3.3+ this time. So you always should run the latest WordPress version for a lot of reasons.

How are new resources being added to the toolbar / admin bar?

Just drop me a note on my Twitter @deckerweb or via my contact page and I’ll add the link(s) if it is useful for admins/ webmasters and the Gravity Forms community.

How could my plugin/extension settings page be added to the admin bar links?

This is possible of course and highly welcomed! Just drop me a note on my Twitter @deckerweb or via my contact page and we sort out the details!
Particularly, I need the admin url for the primary options page (like so wp-admin/admin.php?page=foo). I also need the correct name of the main PHP class or function (to check if the plugin extension exists or not). (I don’t own all the premium stuff myself yet so you’re more than welcomed to help me out with these things. Thank you!)

There are still some other plugins for Gravity Forms out there why aren’t these included by default?

Simple answer: Linking/ adding is only possible where a plugin has its own admin pages and these are properly accessable.

Can custom menu items be hooked in via theme or other plugins?

Yes, this is possible since version 1.5 of the plugin! There are 3 action hooks available for hooking custom menu items in — gftb_custom_main_items for the main section, gftb_custom_extension_items for the exentensions section plus gftb_custom_group_items for the resource group section. Here’s an example code:

add_action( 'gftb_custom_group_items', 'gftb_custom_additional_group_item' );
/**
 * Gravity Forms Toolbar: Custom Resource Group Items
 *
 * @global mixed $wp_admin_bar
 */
function gftb_custom_additional_group_item() {

    global $wp_admin_bar;

    $wp_admin_bar->add_menu( array(
        'parent' => 'ddw-gravityforms-gfgroup',
        'id'     => 'your-unique-item-id',
        'title'  => __( 'Custom Menu Item Name', 'your-textdomain' ),
        'href'   => 'http://deckerweb.de/',
        'meta'   => array( 'title' => __( 'Custom Menu Item Name Tooltip', 'your-textdomain' ) )
    ) );
}

Can certain sections be removed?

Of course, just via plugin options! — Additionally, you can use some constants – which can come in handy for customizing stuff for clients etc. You can remove the following sections: Official “Add-Ons” (all items) / “Extensions” area (all items) / “Resources link group” at the bottom (all items) / “German language stuff” (all items) / “Dutch language stuff” (all items)

To achieve this add one, some or all of the following constants to your theme’s/child theme’s functions.php file:

/** Gravity Forms Toolbar: Remove Add-On Items */
define( 'GFTB_ADDONS_DISPLAY', FALSE );

/** Gravity Forms Toolbar: Remove Extensions Items */
define( 'GFTB_EXTENSIONS_DISPLAY', FALSE );

/** Gravity Forms Toolbar: Remove Resource Items */
define( 'GFTB_RESOURCES_DISPLAY', FALSE );

/** Gravity Forms Toolbar: Remove German Language Items */
define( 'GFTB_DE_DISPLAY', FALSE );

/** Gravity Forms Toolbar: Remove Dutch Language Items */
define( 'GFTB_NL_DISPLAY', FALSE );

/** Gravity Forms Toolbar: Remove Spanish Language Items */
define( 'GFTB_ES_DISPLAY', FALSE );

Can the the whole toolbar entry be removed, especially for certain users?

Yes, that’s also possible! This could be useful if your site has special user roles/capabilities or other settings that are beyond the default WordPress stuff etc. For example: if you want to disable the display of any “Gravity Forms Toolbar” items for all user roles of “Editor” please use this code:

/** Gravity Forms Toolbar: Remove all items for "Editor" user role */
if ( current_user_can( 'editor' ) ) {
    define( 'GFTB_DISPLAY', FALSE );
}

To hide only from the user with a user ID of “2”:

/** Gravity Forms Toolbar: Remove all items for user ID 2 */
if ( 2 == get_current_user_id() ) {
    define( 'GFTB_DISPLAY', FALSE );
}

To hide items only in frontend use this code:

/** Gravity Forms Toolbar: Remove all items from frontend */
if ( ! is_admin() ) {
    define( 'GFTB_DISPLAY', FALSE );
}

In general, use this constant do hide any “Gravity Forms Toolbar” items:

/** Gravity Forms Toolbar: Remove all items */
define( 'GFTB_DISPLAY', FALSE );

Available Filters to Customize More Stuff

All filters are listed with the filter name in bold and the below additional info, helper functions (if available) as well as usage examples.

gftb_filter_capability_all

• Default value: gravityforms_edit_forms (set by Gravity Forms plugin itself!)

• 6 Predefined helper functions:

  • __gftb_admin_only — returns 'administrator' role — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_admin_only’ );

  • __gftb_role_editor — returns 'editor' role — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_role_editor’ );

  • __gftb_cap_manage_options — returns 'manage_options' capability — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_cap_manage_options’ );

  • __gftb_cap_install_plugins — returns 'install_plugins' capability — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_cap_install_plugins’ );

  • __gftb_cap_activate_plugins — returns 'activate_plugins' capability — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_cap_activate_plugins’ );

  • __gftb_cap_edit_theme_options — returns 'edit_theme_options' capability — usage:

  add_filter( ‘gftb_filter_capability_all’, ‘__gftb_cap_edit_theme_options’ );

• Another example:

  add_filter( ‘gftb_filter_capability_all’, ‘custom_gftb_capability_all’ );
  /**

  • Gravity Forms Toolbar: Change Main Capability
    */
    function custom_gftb_capability_all() {
    return ‘switch_themes’;
    }

–> Changes the capability to switch_themes

gftb_filter_main_icon

• Default value: Gravity Forms logo (favicon) 🙂

• 10 Predefined helper functions for the 11 included colored icons, returning special colored icon values – the helper function always has this name: __gftb_colornamehere_icon() this results in the following filters ready for usage:

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_blue_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_lightgreen_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_lightgrey_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_orange_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_pink_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_red_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_turquoise_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_yellow_icon’ );

  add_filter( ‘gftb_filter_main_icon’, ‘__gftb_theme_images_icon’ );

–> Where the last helper function returns the icon file (icon-gftb.png) found in your current theme’s/child theme’s /images/ subfolder

• Example for using with current child theme:

  add_filter( ‘gftb_filter_main_icon’, ‘custom_gftb_main_icon’ );
  /**

  • Gravity Forms Toolbar: Change Main Icon
    */
    function custom_gftb_main_icon() {
    return get_stylesheet_directory_uri() . ‘/images/custom-icon.png’;
    }

–> Uses a custom image from your active child theme’s /images/ folder

–> Recommended dimensions are 16px x 16px

gftb_filter_main_icon_display

• Returning the CSS class for the main item icon
• Default value: icon-gravityforms (class is: .icon-gravityforms)

• 1 Predefined helper function:

  • __gftb_no_icon_display() — usage:

  add_filter( ‘gftb_filter_main_icon_display’, ‘__gftb_no_icon_display’ );

–> This way you can REMOVE the icon!

• Another example:

  add_filter( ‘gftb_filter_main_icon_display’, ‘custom_gftb_main_icon_display_class’ );
  /**

  • Gravity Forms Toolbar: Change Main Icon CSS Class
    */
    function custom_gftb_main_icon_display_class() {
    return ‘your-custom-icon-class’;
    }

–> You then have to define CSS rules in your theme/child theme stylesheet for your own custom class .your-custom-icon-class

–> Recommended dimensions are 16px x 16px

gftb_filter_main_item

• Default value: “Gravity Forms”

• Example code for your theme’s/child theme’s functions.php file:

  add_filter( ‘gftb_filter_main_item’, ‘custom_gftb_main_item’ );
  /**

  • Gravity Forms Toolbar: Change Main Item Name
    */
    function custom_gftb_main_item() {
    return __( ‘Your custom main item title’, ‘your-textdomain’ );
    }

gftb_filter_main_item_tooltip

• Default value: “Gravity Forms”

• Example code for your theme’s/child theme’s functions.php file:

  add_filter( ‘gftb_filter_main_item_tooltip’, ‘custom_gftb_main_item_tooltip’ );
  /**

  • Gravity Forms Toolbar: Change Main Item Name’s Tooltip
    */
    function custom_gftb_main_item_tooltip() {
    return __( ‘Your custom main item title tooltip’, ‘your-textdomain’ );
    }

Final note: I DON’T recommend to add customization code snippets to your main theme’s/child theme’s functions.php file! Please use a functionality plugin or an MU-plugin instead! This way you can also use this better for Multisite environments. In general you are then more independent from theme/child theme changes etc. If you don’t know how to create such a plugin yourself just use one of my recommended ‘Code Snippets’ plugins. Read & bookmark these Sites:

• “What is a functionality plugin and how to create one?” – blog post by WPCandy
• “Creating a custom functions plugin for end users” – blog post by Justin Tadlock
• DON’T hack your functions.php file: Resource One – Resource Two (both by Thomas Griffin Media)
• “Code Snippets” plugin by Shea Bunge – also network wide!
• “Code With WP Code Snippets” plugin by Thomas Griffin – Note: Plugin currently in development at GitHub.
• “Toolbox Modules” plugin by Sergej Müller – see also his plugin instructions.

All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/2732242 (you can also add your questions/ feedback there 🙂

1.7.0 (2014-02-26)

• NEW: Added little user message if base plugin “Gravity Forms” is not active on activation of toolbar add-on.
• UPDATE: Fixed API Settings link for all non-translated installs.
• UPDATE: Improved language plugins/ files support.
• CODE: More internal code/ documentation updates and improvements.
• UPDATE: Updated German translations, plus all user-submitted trnaslations and also the .pot file for all translators!
• Extended plugin support:
  • NEW: Added plugin support for “Gravity Forms Styler” (premium, by WordPress Gurus via CodeCanyon Marketplace).
  • NEW: Added plugin support for “SP Gravity Forms MySQL Connect” (premium, by Ralf Fuhrmann/ profine GmbH via CodeCanyon Marketplace).
  • NEW: Added plugin support for “Rcwd Upload for Gravity Forms” (premium, by Roberto Cantarano via CodeCanyon Marketplace).
  • NEW: Added plugin support for “Groups Gravity Forms Integration” (premium, by itthinx/ Karim Rahimpur via CodeCanyon Marketplace).
  • NEW: Added plugin support for “Gravity Forms MailPoet/ Wysija Add-on” (free, by Ben Hays).
  • NEW: Added plugin support for “Gravity Forms Marketo Add-On” (free, by Katz Web Services, Inc.).
  • NEW: Added plugin support for “Gravity Forms Advanced File Uploader” (free, by Benjamin Moody).
  • NEW: Added plugin support for “Gravity Forms Paystation (3 party hosted)” (free, by Paystation Limited).
  • NEW: Added plugin support for “Gravity Forms + First Data Global Gateway e4℠” (free, by Aubrey Portwood of Excion).
  • NEW: Added plugin support for “Gravity Forms Highrise CRM” (free, by Ben Hays).
  • NEW: Added plugin support for “Gravity Forms Convio Add-on” (free, by Ben Hays).
  • NEW: Added plugin support for “Gravity Forms Highrise Add-On” (free, by Katz Web Services, Inc.).
  • NEW: Added plugin support for “Gravity Forms Periodic Notification” E-Mails (free, by Weptile).
  • NEW: Added language plugin support for “Gravity Forms (Spanish)” (free, by Closemarketing).

1.6.0 (2014-02-24)

• NEW: Plugin’s Toolbar settings now also accessable from the Gravity Forms settings page, as a sub settings link – like it’s used by lots of other extensions as well.
• UPDATE: Updated Gravity Forms settings links where necessary; added new “API” settings link.
• UPDATE: Updated resource links where necessary.
• UPDATE: Removed old CSS support for some older WordPress versions.
• UPDATE: Improved some CSS styling for WordPress 3.8+.
• CODE: Code/ documentation updates and improvements.
• UPDATE: Updated readme.txt file here.
• UPDATE: Updated German translations and also the .pot file for all translators!
• Extended official add-on support:
  • NEW: Added support for these official add-ons by Rocketgenius: Coupons, PayPal Payments Pro, Zapier, Logging, Meta Recovery Utility
• Extended plugin support:
  • NEW: Added plugin support for “Gravity Forms Connect to Google Calendar™” (premium, by Eugen Oprea via CodeCanyon Marketplace).
  • NEW: Added plugin support for “Gravity Perks” (premium, by David Smith/ gravitywiz.com), including support for Perks with extra settings/ admin pages (currently the case for the Perk “Email Users”).
  • NEW: Added plugin support for “Gravity Forms Survey Results” (free, by Daniel Grundel (dgrundel) and Mahmoud Kassassir (mkassassir), Web Presence Partners – via GitHub).
  • NEW: Added plugin support for “Gravity Forms Conditional Notifications Add-On” (free, by Gennady Kovshenin via GitHub).
  • NEW: Added plugin support for “Gravity Forms Saved Forms Add-On” (free, by Gennady Kovshenin via GitHub).
  • NEW: Added plugin support for “Gravity Forms DPS PxPay” (free, by WebAware).
  • NEW: Added plugin support for “Gravity Forms Mass Import” (free, by Aryan Duntley).
  • NEW: Added plugin support for “Gravity Forms Quantity Limits” (free, by Ben Hays).
  • NEW: Added plugin support for “Gravity Forms Blue Pay Add-On” (free, by David Cramer).
  • NEW: Added plugin support for “Are You A Human” (free, by Are You A Human) — a anti-spam solution and “CAPTCHA” replacement!
  • NEW: Added plugin support for “Aviary Editor Addon For Gravity Forms” (free, by Leon Kiley – NetherWorks, LLC).
  • UPDATE: Improved plugin support for “Pronamic iDEAL” – updated all settings; plus: code parts now only loaded if plugin is active – requires now add-on version v2.6.1 or higher!

1.5.1 (2012-12-12)

• NEW: Added new settings options to plugins own settings – thanks to co-author Milan! 🙂 — You can now set Toolbar Menu visibility for the plugin for frontend and backend!
• NEW: Added plugin support for “Gravity Forms YMLP Add-on” (free, by Katz Web Services, Inc.).
• CODE: Minor code/documentation updates & improvements.
• UPDATE: Updated readme.txt file here.
• UPDATE: Updated German translations and also the .pot file for all translators!
• UPDATE: Moved screenshots to ‘assets’ folder in WP.org SVN to reduce plugin package size.

1.5.0 (2012-09-16)

• Extended Add-On/ Plugin support:
  • NEW: Added support for newly released official “Picatcha Add-On” (anti spam).
  • UPDATE: Updated support for official “User Registration” Add-On to support new features introduced with v1.5+ of this Add-On.
  • NEW: Added plugin support for “Gravity Forms Fat Zebra Add-On (free, by Matthew Savage).
  • NEW: Added plugin support for “Gravity Forms Survey Funnel Add-On (free, by Pronamic).
  • NEW: Added plugin support for “Gravity Forms Infusionsoft Add-On (free, by Katz Web Services, Inc.)
• More stuff:
  • NEW: Added help tab on plugin’s settings page.
  • NEW: Moved resources and links group from plugin main file to extra files for performance optimization if this group might be disabled via settings/ constant.
  • CODE: Minor code/documentation updates & improvements.
  • UPDATE: Updated German translations and also the .pot file for all translators!
  • UPDATE: Initiated new three digits versioning, starting with this version.
  • UPDATE: Moved screenshots to ‘assets’ folder in WP.org SVN to reduce plugin package size.

1.4.1 (2012-05-20)

• Important bugfix release!
• FIX: Fixed problem with capabilities not set correctly when using/not using “Members” plugin. Now Gravity Forms Toolbar has more additional checks built in and this should finally work for all, at least all admins (for which this plugin is!).
• FIX: Fixed another bug when Gravity Forms is not active, to properly activate this plugin.
• CODE: Other minor code and documentation tweaks & improvements.

1.4.0 (2012-05-19)

• New features:
  • NEW: Added new plugin setting (plus an additional constant) for removing the official add-on items/hook place in the menu.
  • COOL: Plugin can now be branded and customized a lot more!
  • NEW: Added 3 action hooks for hooking custom menu items in – see FAQ section here for more info on that.
  • NEW: Added 5 filters to change icon graphic, main item name, main capability and more! For these cases there are now the new built-in filters and helper functions available! (See “FAQ” section here)
  • NEW: Added alternate main Icon in 8 additional colors (changeable via filters).
  • NEW: Almost all sections can now be removed for special needs, capabilities etc. — all done via constants in your active theme/child theme — this way you can customize for your staff members or clients if you need some more users with extended or restricted admin bar/toolbar access (See “FAQ” section here) — this is additional to the existing settings via plugin’s options page!
• Extended Add-On/ Plugin support:
  • NEW: Added support for newly released official “PayPal Pro Add-On”
  • NEW: Added plugin support for “Gravity Forms Stripe Add-On (free, by Naomi C. Bush)
  • NEW: Added plugin support for “Gravity Forms Constant Contact Add-On (free, by Katz Web Services, Inc.)
  • NEW: Added plugin support for “Gravity to Solve360 (free, by Steve Barnett)
  • NEW: Added plugin support for “Gravity Forms HubSpot Add-On (free, by Dan Zappone)
  • NEW: Added plugin support for “Gravity Forms CapsuleCRM Add-On (free, by Alinea.im)
  • NEW: Added plugin support for “PixCaptcha Image Captcha for Gravity Forms” (free, by Picatcha, Inc.)
  • NEW: Added plugin support for “GravityForms eWAY” (free, by WebAware)
  • NEW: Added plugin support for “Gravity Forms – SMS Notifications” (free, by Mediaburst)
• More stuff:
  • NEW: Added link to plugin’s settings page on ‘Plugins’ page in ‘wp-admin’.
  • NEW: Added Lithuanian translations by Vincent G. 🙂
  • UPDATE: Updated German and Serbian translations and also the .pot file for all translators!
  • NEW: Easy plugin translation platform with GlotPress tool: Translate “Gravity Forms Toolbar”…
  • CODE: Minor code and documentation tweaks & improvements.
  • UPDATE: Updated documentation and FAQ of readme.txt file.
  • UPDATE: Extended GPL License info in readme.txt as well as main plugin file.

1.3.0 (2012-02-24)

• Further enhancements and additions for plugin’s own settings/features:
  • NEW: Display notifications when new Gravity Forms plugin update is available.
  • NEW: Settings to control menu items notifications display for updates and unread entries.
  • NEW: Toolbar menu item for Gravity Forms Toolbar plugin settings.
• Extended add-on and resources support:
  • NEW: Added support for newly released official “Authorize.Net Add-On”
  • NEW: Added Gravity Forms News Planet feed link to resource links (you can also access this from here: http://friendfeed.com/gravityforms-news)
• Other stuff:
  • CHANGE: Changed wording from “Gravity Forms Main Settings” to just “Plugin Settings”
  • IMPROVEMENT: For WordPress 3.3+ changed display of resource links group: now at the bottom, below settings links and in WP 3.3 group style 🙂
  • CODE: No longer loading CSS styles or menu items for not logged-in users when plugins like “GD Press Tools” are active (which have options to show toolbar / admin bar also for visitors…)
  • CODE: Minor code/ code documenation tweaks.
  • UPDATE: Updated readme.txt file and all screenshots.
• Translations related:
  • NEW: Added possibility for custom and update-secure language files for this plugin – just upload them to /wp-content/languages/gravity-forms-toolbar/ (just create this folder) – this enables you to use complete custom wording or translations.
  • NEW: Added Serbian translations by Dev4Press 🙂
  • UPDATE: Updated German translations and also the .pot file for all translators!

1.2.1 (2012-02-06)

• BUGFIX: Fixed capability issue for displaying plugin’s options page when “Members” plugin is installed
• CODE: Improved conditional check for Dutch language plugin; also, some more minor tweaks and improvements
• UPDATE: Fixed errors in .pot file from v1.2.0 – updated German translations and also the .pot file for all translators!

1.2.0 (2012-02-03)

• Extended plugin functionality a lot, making it even more useful! – Thanx to new plugin co-author Milan Petrovic of Dev4Press!
  • NEW: Admin settings page to optinally remove “Support/Docs/FAQ” and/or “Active Extensions” sections from menu (settings under “General Settings”)
  • NEW: Admin settings allow also to dynamically add existing “Forms” (link to their edit pages) and “Entries” of these forms
  • NEW: Visual notification of new entries in the toolbar (top level) and on “Entries” sub-level (if dynamic entries are activated)
• CODE: Improved conditional check for Dutch language plugin (only display link if plugin is not activated)
• UPDATE: Extended and improved readme.txt file
• UPDATE: Updated German translations and also the .pot file for all translators!

1.1.0 (2012-01-31)

• Extended the third-party plugin support even more:
  • NEW: Added link to user profile at Gravity Help – for even easier access to your forum favorites etc. (only displaying for admins)
  • NEW: Added link to official blog post, documenting about “Gravity Forms CSS: Targeting Specific Elements” (Rocketgenius Blog)
  • NEW: Added useful resource link for CSS styling (plugin “Gravity Forms CSS Ready Class Selector”)
  • NEW: Added plugin support for “Gravity Forms iContact Add-On (free, by Katz Web Services, Inc.)
  • NEW: Added plugin support for “Gravity Forms Mad Mimi Add-On (free, by Katz Web Services, Inc.)
  • NEW: Added plugin support for “Gravity Forms ExactTarget Add-On (free, by Katz Web Services, Inc.)
  • NEW: Added plugin support for “Gravity Forms ShootQ Add-On (free, by pussycatdev)
  • NEW: Added plugin support for “Members (free, by Justin Tadlock)
• BUGFIX: Corrected variable for Dutch language plugin, making link display finally work 🙂
• CODE: Minor tweaks and improvements.
• UPDATE: Updated German and translations and also the .pot file for all translators!
• NEW: Added banner image on WordPress.org for better plugin branding 🙂

1.0.0 (2012-01-22)

• Initial release