This plugin adds useful admin links and resources for the Easy Digital Downloads plugin to the WordPress Toolbar / Admin Bar.
Have Quicker Access to Your Digital Downloads – Time Saver!
This small and lightweight plugin extension just adds a lot Easy Digital Downloads plugin related resources to your toolbar / admin bar. Also links to all setting/ tab pages of the plugin are added making life administrators a lot easier. So you might just switch from the fontend of your site to ‘Payment History’ or to the ‘Add new Download’ page etc.
As the name suggests this plugin is intended towards webmasters and administrators. The new toolbar / admin bar entries will only be displayed if the current user has the WordPress cabability of edit_posts
. (Note: I am open for suggestions here if this should maybe changed to a more suitable capability.)
edd-toolbar.pot
) for translators is also always included πA plugin from deckerweb.de and GenesisThemes
Enjoy using Easy Digital Downloads Toolbar? Please consider making a small donation to support the project’s continued development.
/wp-content/languages/edd-toolbar/
(just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like edd-toolbar-en_US.mo/.po
to achieve that (for creating one see the following tools).Easy plugin translation platform with GlotPress tool:Translate “Easy Digital Downloads Toolbar”…
Note: All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome “Codestyling Localization” plugin and for validating the “Poedit Editor”, which works fine on Windows, Mac and Linux.
Idea Behind / Philosophy: Just a little leightweight plugin for all the Easy Digital Downloads plugin users out there to make their daily web admin life a bit easier. I’ll try to add some plugin/extension support if it makes some sense in the future. So stay tuned :).
I owe huge thanks to Pippin Williamson from PippinsPlugins.com who had the original idea for this plugin. He was absolutely helpful and supportive when creating this plugin. Just check out his awesome stuff and support his great work for WordPress!
edd-toolbar
folder to the /wp-content/plugins/
directory — or just upload the ZIP package via ‘Plugins > Add New > Upload’ in your WP AdminNote: It’s not required to also have the “Easy Digital Downloads” plugin installed but without it this toolbar plugin makes absolutely no sense! — I recommend to use my plugin with “Easy Digital Downloads” v1.0.5 or higher.
Own translation/wording: For custom and update-secure language files please upload them to /wp-content/languages/edd-toolbar/
(just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like edd-toolbar-en_US.mo/.po
to achieve that (for creating one see the tools on “Other Notes”).
Easy Digital Downloads Toolbar in action - primary level (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - a second level - add new download (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - a second level - settings: payment gateways (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - a third level - resources: support forums (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - a third level - resources: documentation (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - a secondary level - resources: plugin headquarters & stuff (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - language specific links at the bottom - for German locales (Click here for larger version of screenshot)
Easy Digital Downloads Toolbar in action - additional plugin settings under "Misc" in EDD settings - new option since plugin version 1.1+ (Click here for larger version of screenshot)
Yes, this plugin works really fine with the latest WordPress 3.3+ including latest 3.4-beta!
And sorry, it DOES NOT work with older WordPress versions so please update your install if you haven’t done yet :).
Just drop me @deckerweb or Pippin Williamson @pippinsplugins a note via Twitter or via our contact pages and we’ll add the link if it is useful for admins/ webmasters and the Easy Digital Downloads plugin ecosystem.
Yes, it is! π Works really fine in Multisite invironment – here I just recommend to activate on a per site basis so to load things only where and when needed.
Yes, you could. — However, it doesn’t make much sense. The plugin is intented for a per site use as the admin links refer to the special settings for that certain site/blog. So if you have a Multisite install with 5 sites but only 3 would run “Easy Digital Downloads” then the other 2 sites will only see support links in the Toolbar / Admin Bar… I guess, you got it? π
Though intended for a per site use it could make some sense in such an edge case: if all of the sites in Multisite use Easy Digital Downloads. This might be the case if you use Multisite for multilingual projects, especially via that awesome plugin: https://wordpress.org/extend/plugins/multilingual-press/
This plugin has NO settings page because I believe it’s just not neccessarry. All customizing could be done via filters, constants and regular WordPress user roles & capabilities. As the plugin is indended for a admin/ webmaster use that’s the way to go. This way we can save the overhaul of an options panel/settings page, additional database storing & requests, uninstall routines and such. End result: a lightweight system that just works and saves clicks & time :-).
Yes, this is possible since version 1.2 of the plugin! There are two action hooks available for hooking custom menu items in — eddtb_custom_main_items
for the main section and eddtb_custom_group_items
for the resource group section. Here’s an example code:
add_action( 'eddtb_custom_group_items', 'eddtb_custom_additional_group_item' ); /** * Easy Digital Downloads Toolbar: Custom Resource Group Items * * @global mixed $wp_admin_bar */ function eddtb_custom_additional_group_item() { global $wp_admin_bar; $wp_admin_bar->add_menu( array( 'parent' => 'ddw-edd-eddbar', 'title' => __( 'Custom Menu Item Name', 'your-textdomain' ), 'href' => 'http://deckerweb.de/', 'meta' => array( 'title' => __( 'Custom Menu Item Name Tooltip', 'your-textdomain' ) ) ) ); }
Yes, this is possible! You can remove the following links or sections: “Add-Ons” settings link, “Resources link group” at the bottom (all items), “German language stuff” (all items) and “Translations resources” (all items)
To achieve this add one, some or all of the following constants to your current theme’s/child theme’s functions.php
or similar file:
/** Easy Digital Downloads Toolbar: Remove Add-On(s) Item(s) */ define( 'EDDTB_ADDONS_DISPLAY', FALSE ); /** Easy Digital Downloads Toolbar: Remove Resource Items */ define( 'EDDTB_RESOURCES_DISPLAY', FALSE ); /** Easy Digital Downloads Toolbar: Remove German Language Items */ define( 'EDDTB_DE_DISPLAY', FALSE ); /** Easy Digital Downloads Toolbar: Remove Translations Items */ define( 'EDDTB_TRANSLATIONS_DISPLAY', FALSE );
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 “Easy Digital Downloads Toolbar” items for all user roles of “Editor” please use this code:
/** Easy Digital Downloads Toolbar: Remove all items for "Editor" user role */ if ( current_user_can( 'editor' ) ) { define( 'EDDTB_DISPLAY', FALSE ); }
To hide only from the user with a user ID of “2”:
/** Easy Digital Downloads Toolbar: Remove all items for user ID 2 */ if ( 2 == get_current_user_id() ) { define( 'EDDTB_DISPLAY', FALSE ); }
To hide items only in frontend use this code:
/** Easy Digital Downloads Toolbar: Remove all items from frontend */ if ( ! is_admin() ) { define( 'EDDTB_DISPLAY', FALSE ); }
In general, use this constant do hide any “Easy Digital Downloads Toolbar” items:
/** Easy Digital Downloads Toolbar: Remove all items */ define( 'EDDTB_DISPLAY', FALSE );
All filters are listed with the filter name in bold and the below additional info, helper functions (if available) as well as usage examples.
eddtb_filter_capability_all
edit_theme_options
4 Predefined helper functions:
__eddtb_admin_only
— returns 'administrator'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_admin_only’ );
__eddtb_role_editor
— returns 'editor'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_role_editor’ );
__eddtb_role_shop_manager
— returns 'shop_manager'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_role_shop_manager’ );
__eddtb_role_shop_accountant
— returns 'shop_accountant'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_role_shop_accountant’ );
__eddtb_role_shop_worker
— returns 'shop_worker'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_role_shop_worker’ );
__eddtb_role_shop_vendor
— returns 'shop_vendor'
role — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_role_shop_vendor’ );
__eddtb_cap_manage_options
— returns 'manage_options'
capability — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_cap_manage_options’ );
__eddtb_cap_edit_theme_options
— returns 'edit_theme_options'
capability — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_cap_edit_theme_options’ );
__eddtb_cap_install_plugins
— returns 'install_plugins'
capability — usage:add_filter( ‘eddtb_filter_capability_all’, ‘__eddtb_cap_install_plugins’ );
Another example:
add_filter( ‘eddtb_filter_capability_all’, ‘custom_eddtb_capability_all’ );
/**
–> Changes the capability to activate_plugins
eddtb_filter_main_icon
11 Predefined helper functions for the 22 included colored/alternate icons, returning special colored icon values – the helper function always has this name: __eddtb_colornamehere_icon()
this results in the following filters ready for usage:
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_blue2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_brown2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_gray2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_green2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_khaki2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_orange2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_pink2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_red2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_turquoise2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_yellow2_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_blue_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_brown_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_gray_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_green_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_khaki_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_orange_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_pink_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_red_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_turquoise_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_yellow_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_alternate_icon’ );
add_filter( ‘eddtb_filter_main_icon’, ‘__eddtb_theme_images_icon’ );
–> Where the 2nd to last “alternate” icon returns the same icon as in the left-hand EDD menu!
–> Where the last helper function returns the icon file (icon-eddtb.png
) found in your current theme’s/child theme’s images
subfolder
Example for using with current theme/child theme:
add_filter( ‘eddtb_filter_main_icon’, ‘custom_eddtb_main_icon’ );
/**
–> Uses a custom image from your active child theme’s /images/
folder
–> Recommended dimensions are 16px x 16px
eddtb_filter_main_icon_display
icon-edd
(class is: .icon-edd
)1 Predefined helper function:
__eddtb_no_icon_display()
— usage:add_filter( ‘eddtb_filter_main_icon_display’, ‘__eddtb_no_icon_display’ );
Another example:
add_filter( ‘eddtb_filter_main_icon_display’, ‘custom_eddtb_main_icon_display_class’ );
/**
–> You then have to define CSS rules in your custom.css
file or your child theme/skin stylesheet for your own custom class .your-custom-icon-class
eddtb_filter_main_item
Example code for your functions.php
file or similar file:
add_filter( ‘eddtb_filter_main_item’, ‘custom_eddtb_main_item’ );
/**
eddtb_filter_main_item_tooltip
Example code for your functions.php
file or similar file:
add_filter( ‘eddtb_filter_main_item_tooltip’, ‘custom_eddtb_main_item_tooltip’ );
/**
eddtb_filter_edd_name
eddtb_filter_edd_name_tooltip
Final note: If you don’t like to add your customizations to your functions.php
file or similar file of theme/child theme/skin you can also add them to a functionality plugin or an mu-plugin. This way you can also use this better for Multisite environments. In general you are then more independent from theme/child theme changes etc.
This is possible! Plugin and theme developers could use the included hooks to add stuff to the main items or resource group items section. The hooks are:
eddtb_custom_main_items
for the main sectioneddtb_custom_group_items
for the resource group sectionExample code:
add_action( ‘eddtb_custom_main_items’, ‘eddtb_add_custom_main_items’ );
/**
Final note: I DON’T recommend to add customization code snippets to your theme’s/ child theme’s functions.php
file! Please use a functionality plugin or an MU-plugin instead! This way 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:
functions.php
file: Resource One – Resource Two(both by Thomas Griffin Media)All the custom, branding and developer stuff code above can also be found as a Gist on GitHub: https://gist.github.com/2392882 (you can also add your questions/ feedback there π
eddtb_custom_main_items
for the main section and eddtb_custom_group_items
for the resource group section (See FAQ section here for more info on that).http://yoursite.com/downloads/
to get quick access to your downlods listing. Note, also supports user-defined slug via EDD_SLUG
constant (since EDD v1.0.3)!