Genesis Admin Bar Plus: Easy access to relevant Genesis resources

[imp_desc]

This plugin adds resources links related to the Genesis Framework to the admin bar.

These resources include direct links to StudioPress support forums for each theme, quick access to Genesis Theme and SEO settings pages, quick access to Genesis-related plugin settings pages (for those that are active), and links to useful tutorial pages for how to get the most out of Genesis.

The plugin is built with theme and plugin developers in mind, as they can add support for their product with only a few lines of code, giving their users instant access to the right support board, a link to their website etc.

Adds support for menu item positioning, so custom entries can be added anywhere, and not just as the final items.
Easy addition of Support board links via single lines in theme functions.php.

This plugin is conceptual fork of the Genesis Admin Bar Addition plugin, re-written from scratch, adding new features.

Please report issues at https://github.com/GaryJones/Genesis-Admin-Bar-Plus/issues and not the WP Forums.

Download

Download from WordPress Plugin Repository: Genesis Admin Bar PlusEasy access to relevant Genesis resources v1.3.0 (7688 downloads).

Installation

Unzip and upload genesis-admin-bar-plus folder to the /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress
Ensure you’re displaying the admin bar (front and / or back-end) via the settings on the User Profile page.

FAQ

Can I add my own entries to the Genesis menus?

Yes – there is an action hook to do this. See the Add Custom Items section.

How do I add a link to a certain support board?

The plugin currently recognises all of the child theme support boards, Genesis, the translations board, the general plugins board and the GenesisConnect board.
See the Add Support Boards section for an example of how to add these to the Support menu.

You can also add a reference to another board via the gabp_support_boards filter.

What settings links are supported?

The following theme and plugins, when active, have a link to their settings page added to the Settings submenu:

A plugin author can add support for their own settings page link. See the Add Custom Items section.

Genesis Simple Menus and Genesis Tabs can’t be supported as they have no individual settings pages.

Changelog

1.3.0

Added Italian language files to the plugin (props [http://gidibao.net/](Gianni Diurno))
Added support for AgentPress 2, Backcountry, Balance, eleven40, Generate and Luscious themes.
Added support for Clip Cart, Cre8tive Burst, Curtail, Driskill, Politica and Pure Elegance Marketplace themes.
Improved icon markup and styles to match how WP 3.3 does it, which fixes overlapping icon issue.
Improved properties and methods by declaring public or private visibility.
Fixed to use new /tutorials links as StudioPress re-arrange their site.
Fixed to use stricter code standards above and beyond WP CS.

1.2.5

Added support for Fashionista, Modern Blogger (both Marketplace) and Scribble themes.
Added updated German language files back in with the plugin (props [http://deckerweb.de/material/sprachdateien/genesis-plugins/](David Decker))
Improved a few strings to use the plugin text domain to avoid conflicts.
Improved readme descriptions.

1.2.4

Added support for Nitrous and Legacy (Marketplace) themes.

1.2.3

Added support for Genesis Slider plugin.

1.2.2

Added support for various child theme support boards.

1.2.1

Added styles for RTL languages.
Removed German translation files, and included a link in the new Translation section of the readme.

1.2.0

Added support for Genesis Simple Breadcrumbs plugin.
Added support for Free Child Themes support board.
Improved code to eliminate global constant and allow actions and filters to be unhooked by other plugins or functions.php.
Removed two links due to StudioPress website re-organisation.
Now requires PHP 5.

1.1.4

Added support boards for newly-released Midnight and Blissful themes.
Updated German translation.

1.1.3

Fixed issue with sub sub menus, affecting FAQ links.
Child menu items can now be added before parent items – the calculated positioning will add in the sum of all given ancestor item positions.
Fixed confusing interface by styling non-links to use the default cursor.
Updated all screenshots – now up to date, and considerably smaller file-size.
Added explicit licensing of GPLv3.

1.1.2

Fixed URLs from being echoed to bottom of admin pages.

1.1.1

Added option to enter GABP Debug mode by appending gabp-debug as querystring argument.
Fixed translation files by renaming them.
Added a Codex suggestion, to check for translation files in wp-content/languages/ first.

1.1

Improved menu position – now each sub menu can start numbering items from 0, as child menu item will automatically be given a minimum position value of its parent.
Added debug mode (uncomment line at top of plugin file). Can be used to show calculated menu position.

1.0.1

Added further checks to see if plugin is active.
Improved inconsistent external link icon by replacing CSS Unicode characters with base64 encoded image.
Included .pot file for translations.
Added German translation files (props deckerweb.de).
/)).

1.0

First public version.

Comments

Bill Murray says:

2011-04-03 at 04:57

Gary,

Thanks for the handy plugin. Can you provide an example of adding a top level menu choice with a child item?

- Gary says:
  
  2011-04-03 at 09:40
  
  Top level as in next to Comments, Appearance, Genesis, or at the same level as Support, Codex, StudioPress and Settings?
  
  - Bill Murray says:
    
    2011-04-03 at 14:26
    
    Top as in Comments, Appearance, and Genesis. There can only be 1 top, and Support, Codex, etc are below those others. Also, can you clarify how to set the “position” variable? Looking at the code, it appears top level menu items like Genesis have positions in the double digits and lower menu items have positions in the triple digits, but does position affect the parent/child relationship?
    
    - Gary says:
      
      2011-04-03 at 15:50
      
      For generally adding a top level menu and child item, see http://wpengineer.com/2113/add-menus-to-the-admin-bar-of-wordpress/ or other tutorials.
      
      The position – if you look in the plugin code, there are comments about what level position each item is at (Support =100, Codex = 200, StudioPress=300, Settings=400, etc). Child items MUST have a higher number position than the parent, so, for instance, all items in the Settings menu must be 401 or greater – the plugin adds items in at 410, 420, 430, 440 etc. It doesn’t matter if the child item goes higher than the next 100 value e.g. a StudioPress submenu item could have a value of 1000000 if you wanted to make sure it was almost certainly going to always appear last in that menu. The numbers themselves are arbitrary – only the ordering is important.
      
      This is so when all of the menu items are ordered by position, and then added, the parent menu item exists by the time the child menu item wants to be added in its submenu. I’m hoping the next version of the plugin will automatically add the parent item’s position to the child item’s position, meaning any menu positions can simply be given from 0 – with no need to have a minimum as the parent item position.
      
      - Bill Murray says:
        
        2011-04-04 at 02:36
        
        Thanks, Gary. Yours is a neat little plugin that made me re-think the power of the admin bar.
      - Gary says:
        
        2011-04-16 at 12:50
        
        Bill,
        
        The just-released version 1.1 now deals with the menu item positioning issue; the calculated child item position will be the given child item position + the parent position. In short, this means you can start numbering the items in each menu block from 0. The default items happens to go up in 10′s, just to make adding intermediate items not have to go in to non-integers.
David Decker says:

2011-04-12 at 11:46

Hi Gary, really helpful plugin!!
You can add my German translation of the whole thing – you’ll find my language files here:
http://deckerweb.de/downloads/genesis-admin-bar-plus-de

Thanx, Dave

- Gary says:
  
  2011-04-12 at 11:51
  
  Ah, thank you! The next version will be coming with a .pot file, so I’ll include the German translation too!
  
Jeremy says:

2011-08-24 at 06:56

Gary,

First, thanks for this great plugin! It is very useful when working with Genesis.

I wanted to let you know that I noticed some strange behavior when using the plugin with the Genesis Associate Child theme. While viewing the site, when you hover over Genesis and then Settings in the Admin Bar menu, the second-level drop-down seems to flicker and can’t be clicked on. I haven’t seen this with any other Genesis Child themes.

Thanks!

-Jeremy

- Gary says:
  
  2011-08-24 at 08:13
  
  Thanks for the heads up. It seems it’s an issue with all sub-sub-menus (try the My Sites -> X -> {this menu}) on the Associate theme (not my plugin), so I’ve reported it back to StudioPress.
  
  - Jeremy says:
    
    2011-08-24 at 15:11
    
    Thanks Gary! I wasn’t sure whether it could be the plugin or the theme, so I figured I’d let you know first.

Genesis Admin Bar PlusEasy access to relevant Genesis resources