WordPress.org

Plugin Links

• Translations (GlotPress)
• User support forums
• Code snippets archive for customizing, GitHub Gist

Donate

Enjoy using WooCommerce Admin Bar Addition? Please consider making a small donation to support the project's continued development.

Translations

• English - default, always included
• German: Deutsch - immer dabei! Download auch via deckerweb.de
• For custom and update-secure language files please upload them to /wp-content/languages/wcaba/ (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 wcaba-en_US.mo/.po to achieve that (for creating one see the following tools).

Easy plugin translation platform with GlotPress tool: Translate "WooCommerce Admin Bar Addition"...

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.

Additional Info

Idea Behind / Philosophy: Just a little leightweight plugin for all the WooCommerce shop managers out there to make their daily shop admin life a bit easier. Integration of extensions and third-party plugins & themes was also an important goal. -- I'll try to add even more plugin/theme support if it makes some sense. So stay tuned :).

WooCommerce News Planet I also have started a little news/feed service via "FriendFeed" that you can subscribe to: http://friendfeed.com/woocommerce-news -- Please contact me via my Twitter for new resources (that have an RSS feed and are WooCommerce-related!)

Credits

• Thanx to WooThemes company and WooCommerce team for promoting this plugin on their official homepage as well as on the download page here on wordpress.org! ;-)
• Thanx to WooCommerce lead developer Mike Jolley for supporting this plugin - and mentioning this in his personal blog :)
• Thanx to the team of ColorLabs & Company for supporting the plugin with their premium theme for WooCommerce
• Thanx to PrimaThemes @PrimaThemes for supporting the plugin with their premium theme "WP Sharp" for WooCommerce
• Thanx to Kriesi @Kriesi for supporting the plugin with his premium themes "Abundance", "Propulsion" and "Flashlight" for WooCommerce
• Thanx to Dominik Schilling @ocean90 for great help with the CSS for the first level icon in WordPress 3.3!

Support for OFFICIAL Plugin Extensions Released by WooThemes

General Extensions

• "WooCommerce Software Add-On" (by WooThemes)
• "WooCommerce Product CSV Import Suite" (by Mike Jolley/WooThemes)
• "WooCommerce Product Image Watermark" (by David Baker)
• "WooCommerce Compare Produts Pro" (by A3 Revolution Software Development) (Note: upcoming release!)
• "WooCommerce Bulk Stock Management" (by Mike Jolley/WooThemes)
• "WooCommerce Branding" (by WooThemes)
• "WooCommerce Print Invoice/Packing List" (by Ilari Mäkelä)
• "WooCommerce E-Mail Attachments" (by Guenter Schoenmann - InoPlugs)
• "WooCommerce Amazon S3 Storage" (by Gerhard Potgieter)
• "WooCommerce jPlayer Product Sampler" (by WooThemes)
• "WooCommerce Wishlist Member Integration" (by Radomir van Dalen)
• "WooCommerce Catalog Visibility Options" (by Lucas Stark)
• "WooCommerce CSV Export" (by Ilari Mäkelä)
• "WooCommerce Facebook Tab" (by David Baker)
• "WooCommerce AWeber Newsletter Subscription" (by Gerhard Potgieter)
• "WooCommerce Commission King" (by Winning Media)
• "WooCommerce Dynamic Pricing" (by Lucas Stark)
• "WooCommerce Substribe to Newsletter" (by WooThemes)
• "WooCommerce Professor Cloud Zoom" (by Andrew Benbow)
• "WooCommerce SMS Notifications" (by Mediaburst & Simon Wheatley)
• "WooCommerce Clickatell SMS Notifications" (by WooThemes)
• "WooCommerce FreshBooks" (by Patrick Garman)
• "SOD QuickBooks Connector" (by Sixty One Designs)

Converters/ Importers

• "WooCommerce - Product Importer Deluxe" (by Visser Labs)
• "Jigoshop to WooCommerce Converter" (by Agus MU)
• "MarketPress to WooCommerce Converter" (by Agus MU)
• "WP e-Commerce to WooCommerce Converter" (by Agus MU)

Of course, only extensions with own settings pages (which are linkable!) could be integrated. More extensions might be added as they become available and I could get my hands on the internal parameters... :-).

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

Add Theme Support for "Order Status" with Counters

Add the following code to your active theme/child theme functions.php file:

/** WooCommerce Admin Bar Addition: Add Order Status Links */
add_theme_support( 'wcaba-order-status' );

--> Links will appear under "Orders" item as sub-level links

Add Theme Support for All the Frontend "Shop Pages" Links

Add the following code to your active theme/child theme functions.php file:

/** WooCommerce Admin Bar Addition: Add Shop Pages Links */
add_theme_support( 'wcaba-shop-links' );

--> Links will appear between "Reports" and "Extensions" -- also the WordPress capability edit_pages is required - because you'll want to edit your stuff right away :)

Add new custom menu items via theme or other plugins

This is possible since version 2.3 of the plugin! There are 4 action hooks available for hooking custom menu items in -- wcaba_custom_main_items for the main section, wcaba_custom_extension_items for the exentensions section, wcaba_custom_theme_items for the theme section plus wcaba_custom_group_items for the resource group section. Here's an example code:

add_action( 'wcaba_custom_group_items', 'wcaba_custom_additional_group_item' );
/**
 * WooCommerce Admin Bar Addition: Custom Resource Group Items
 *
 * @global mixed $wp_admin_bar
 */
function wcaba_custom_additional_group_item() {

    global $wp_admin_bar;

    $wp_admin_bar->add_menu( array(
        'parent' => 'ddw-woocommerce-wcgroup',
        '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' ) )
    ) );
}

Remove Certain Sections from the Toolbar Items

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

/** WooCommerce Admin Bar Addition: Remove ALL Items! */
define( 'WCABA_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove Extensions Items */
define( 'WCABA_EXTENSIONS_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove Themes Items */
define( 'WCABA_THEMES_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove Resource Items */
define( 'WCABA_RESOURCES_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove German Language Items */
define( 'WCABA_DE_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove Dutch Language Items */
define( 'WCABA_NL_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove WC Debug Link */
define( 'WCABA_DEBUG_DISPLAY', FALSE );

/** WooCommerce Admin Bar Addition: Remove Reports/Statistics */
define( 'WCABA_REPORTS_DISPLAY', FALSE );

--> You can also combine these with conditional if statements to customize this even more, for example:

If you want to disable the display of any "WooCommerce Admin Bar Addition" items for all user roles of "Editor" please use this code:

/** WooCommerce Admin Bar Addition: Remove all items for "Editor" user role */
if ( current_user_can( 'editor' ) ) {
    define( 'WCABA_DISPLAY', FALSE );
}

To hide the "Extensions" section only from a user with the user ID of "2", just use this code:

/** WooCommerce Admin Bar Addition: Remove all items for user ID 2 */
if ( 2 == get_current_user_id() ) {
    define( 'WCABA_EXTENSIONS_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.

wcaba_filter_capability_all

• Default value: manage_woocommerce (set by "WooCommerce" plugin itself, the main capability for shop managers!)
• 5 Predefined helper functions:
  • __wcaba_admin_only -- returns 'administrator' role -- usage:

add_filter( 'wcaba_filter_capability_all', '__wcaba_admin_only' );

• __wcaba_role_shop_manager -- returns 'shop_manager' role -- usage:

add_filter( 'wcaba_filter_capability_all', '__wcaba_role_shop_manager' );

• __wcaba_role_editor -- returns 'editor' role -- usage:

add_filter( 'wcaba_filter_capability_all', '__wcaba_role_editor' );

• __wcaba_cap_manage_options -- returns 'manage_options' capability -- usage:

add_filter( 'wcaba_filter_capability_all', '__wcaba_cap_manage_options' );

• __wcaba_cap_install_plugins -- returns 'install_plugins' capability -- usage:

add_filter( 'wcaba_filter_capability_all', '__wcaba_cap_install_plugins' );

• Another example:

add_filter( 'wcaba_filter_capability_all', 'custom_wcaba_capability_all' );
/**
 * WooCommerce Admin Bar Addition: Change Main Capability
 */
function custom_wcaba_capability_all() {
    return 'edit_theme_options';
}

--> Changes the capability to edit_theme_options

wcaba_filter_main_icon

• Default value: WooCommerce cart icon in default color
• 7 Predefined helper functions for the 6 included colored icons, returning special colored icon values - the helper function always has this name: __wcaba_colornamehere_icon() this results in the following filters ready for usage:

add_filter( 'wcaba_filter_main_icon', '__wcaba_blue_icon' );

add_filter( 'wcaba_filter_main_icon', '__wcaba_grey_icon' );

add_filter( 'wcaba_filter_main_icon', '__wcaba_orange_icon' );

add_filter( 'wcaba_filter_main_icon', '__wcaba_pink_icon' );

add_filter( 'wcaba_filter_main_icon', '__wcaba_red_icon' );

add_filter( 'wcaba_filter_main_icon', '__wcaba_teal_icon' );

add_filter( 'wcaba_filter_main_icon', '__bptb_theme_images_icon' );

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

• Another example:

add_filter( 'wcaba_filter_main_icon', 'custom_wcaba_main_icon' );
/**
 * WooCommerce Admin Bar Addition: Change Main Icon
 */
function custom_wcaba_main_icon() {
    return get_stylesheet_directory_uri() . '/images/custom-icon.png';
}

--> Uses a custom image from your active theme's /images/ folder

--> Recommended dimensions are 16px x 16px

wcaba_filter_main_icon_display

• Returning the CSS class for the main item icon
• Default value: icon-woocommerce (class is: .icon-woocommerce)
• 1 Predefined helper function:
  • __wcaba_no_icon_display() -- usage:

add_filter( 'wcaba_filter_main_icon_display', '__wcaba_no_icon_display' );

• This way you can REMOVE the icon!
  • Another example:

add_filter( 'wcaba_filter_main_icon_display', 'custom_wcaba_main_icon_display_class' );
/**
 * WooCommerce Admin Bar Addition: Change Main Icon CSS Class
 */
function custom_wcaba_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

wcaba_filter_main_item

• Default value: "WooCommerce"
• NOTE: Interlinked with "WooCommerce Branding" extension: if you're changing the Name there, then the new value will be applied ALSO to this filter!
• Example code for your theme's functions.php file:

add_filter( 'wcaba_filter_main_item', 'custom_wcaba_main_item' );
/**
 * WooCommerce Admin Bar Addition: Change Main Item Name
 */
function custom_wcaba_main_item() {
    return __( 'Your custom main item', 'your-theme-textdomain' );
}

wcaba_filter_main_item_tooltip

• Default value: "WooCommerce Shop Plugin"
• NOTE: Interlinked with the "WooCommerce Branding" extension: if you're changing the Name there, then the new value will be applied ALSO to this filter!
• Example code for your theme's functions.php file:

add_filter( 'wcaba_filter_main_item_tooltip', 'custom_wcaba_main_item_tooltip' );
/**
 * WooCommerce Admin Bar Addition: Change Main Item Name's Tooltip
 */
function custom_wcaba_main_item_tooltip() {
    return __( 'Your custom main item tooltip', 'your-theme-textdomain' );
}

wcaba_filter_woocommerce_name and wcaba_filter_woocommerce_name_tooltip

• Default value for both: "WooCommerce"
• Used for some items within toolbar links to enable proper branding
• Change things like in the other examples/principles shown above
• NOTE: Interlinked with the "WooCommerce Branding" extension: if you're changing the Name there, then it will be applied ALSO to both of these filters!

Final note: If you don't like to add your customizations to your theme's functions.php file 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 changes etc.

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