Toolbar Extras for Oxygen Builder - Power Up Your Admin Bar
Contributors: daveshine, deckerweb, wpautobahn, toolbarextras
Donate link: https://www.paypal.me/deckerweb
Tags: toolbar, adminbar, admin bar, oxygen, page builder, website, site builder, deckerweb, ddwtoolbar
Requires at least: 4.7
Tested up to: 5.2
Requires PHP: 5.6
Stable tag: 1.2.0
License: GPL-2.0-or-later
License URI: https://opensource.org/licenses/GPL-2.0
Building websites with Oxygen? Your work will get easier & faster with this Toolbar Extras Add-On. Extended plugin support baked right in.
Description
π Quick Access to Your Oxygen Site Building Resources - Big Time Saver. Perfect for Non-Techies and Non-Coder Designers.
This smart WordPress plugin just adds some missed and very useful Oxygen-specific admin links to your Toolbar / Admin Bar. Save scrolling travel and time. Access settings and content pages faster from one central area in the Admin Dashboard AND when on the frontend of your site. Plus few optimizations for Oxygen's own Toolbar within the Builder :-).
original video link by plugin developer David Decker
βΉοΈ Essential: Toolbar Extras for Oxygen Builder is an Add-On plugin, it requires the base plugin "Toolbar Extras".
βΉοΈ Important: "Oxygen Builder" is a premium plugin for WordPress by Soflyy.
βΉοΈ Disclaimer: Toolbar Extras for Oxygen Builder is an independent free plugin by David Decker from DECKERWEB. It does not represent Soflyy/ Oxygen.
β₯οΈ Features - What the Plugin Does
- More links for the "Back to WP" section in Oxygen Builder interface itself -- Oxygen Templates, WordPress Pages, WooCommerce Products, Oxygen User Elements Library
- Optionally open those "Back to WP" links in a new tab/ window -- perfect for previewing your templates/ pages ...
- Useful Row action "Edit with Oxygen" for all Oxygen Template post types, plus any item of an Oxygen-enabled post type that contains an Oxygen Element already
- Useful Post State "Oxygen" appended to all post type items edited with Oxygen - for example for Pages
- Registers Oxygen Builder - set as default Builder for the "Build" Group
- Adds Oxygen Templates links to the "Build" Group in the Toolbar, including Reusable Parts and User Elements Library (2.3+)
- Optionally adds list of Oxygen Templates to the Toolbar as extra group
- Optionally adds list of Oxygen-edited Pages to the Toolbar as extra group
- Label tweaks and additions for Oxygen Templates in the "New Content" Group
- Adds Website install wizard/ Importer to the Toolbar "Build" Group as well - for faster access
- Adds all Oxygen settings and settings tabs links to the Toolbar
- Adds links to settings of Oxygen Add-On Plugins (only if these are active)
- Adds lots of official and Community resources to the Toolbar (optional, can be disabled via settings) - documentation, forum, Facebook Group etc.
- Frontend only: The original Oxygen Toolbar item can be customized - icon, location, label
- Add additional view to filter Oxygen Reusable Parts only - in Templates post type list table (overview table)
- Proper highlighting of Templates submenu in Oxygen's admin menu - so you always know where you are
- Adds new tab on plugin's settings page (under "Settings > Toolbar Extras > Tab: Oxygen") so you have control over what is displayed and what's not!
- Corrected post type labels for Oxygen Templates ('ct_template') and User Elements Library ('oxy_user_library') where needed
- Use any other "global" Toolbar Extras feature like automatic detection of Local Development Enviroment, Dev Mode, and lots of customization options
π More Benefits
- Any items are only loaded if needed
- Perfect integration into Toolbar Extras' items and settings (of course)
- Non-Techie and Non-Coder Designer friendly :)
- At the same time very developer friendly as well - offering quite a few action hooks and filters for customization if needed ;-)
- Clean and efficient code
- Fully internationalized and translateable - also tested/optimized for RTL languages
π Oxygen Add-On Support/ Integration
π A Typical Workflow / Usage
- Install Oxygen Builder, Toolbar Extras, plus the Toolbar Extras Oxygen Add-On - in that order
- In Toolbar Extras settings set Oxygen as your default "Page Builder", set optional background color of Toolbar etc.
- In the Oxygen-specific settings enable or disable various tweaks regarding Oxygen in WP-Admin, the Toolbar, and the Builder itself
- When working on your site(s) focus on the Toolbar in the admin and on the frontend to get a habit for this "central hub"
βΉοΈ Important: Required/ Recommended for plugin usage
- Required: User has role
Administrator
(needed capabilities manage_options
and edit_theme_options
)
- Required: Toolbar/ Admin Bar is enabled (user profile settings in WordPress)
- Required: User is logged in (of course)
- Required: The premium plugin "Oxygen Builder" (version 2.0 or higher) is installed and activated (otherwise this Add-On will do nothing!)
- Recommended: Plugin's settings are enabled to show the wanted links (or any filter/ constant in code)
π Translations
- πΊπΈ English (United States) -
en_US
= default, always included
- π©πͺ German (informal, default) -
de_DE
- π©πͺ German (formal) -
de_DE_formal
.pot
file (toolbar-extras-oxygen.pot
) for translators is always included in the plugin's 'languages' folder :)
π Be a Contributor
If you want to translate, go to the Translation Portal at translate.wordpress.org.
You can also contribute code-wise via our Toolbar Extras for Oxygen Builder GitHub Repository - and see where you can help.
π Documentation and Support
β‘ Liked Toolbar Extras for Oxygen Builder Plugin?
β This Plugin ...
Installation
Minimum Requirements
- Base plugin: Toolbar Extras, version 1.4.6 or higher
- WordPress version 4.7 or higher
- PHP version 5.6.20 or higher
- MySQL version 5.0 or higher
- Administrator user with capabilities
manage_options
and edit_theme_options
who is logged-in and has the Toolbar (Admin Bar) enabled (user profile)
We Recommend Your Host Supports at least:
- PHP version 7.2 or higher
- MySQL version 5.6 or higher / OR MariaDB 10.1 or higher
- HTTPS support
Installation
original video link by plugin developer David Decker
- Install using the WordPress built-in Plugin installer (via Plugins > Add New - search for
toolbar extras oxygen
), or extract the ZIP file and drop the contents in the wp-content/plugins/
directory of your WordPress installation.
- Activate the plugin through the 'Plugins' menu in WordPress.
- Optional: if Toolbar Extras base plugin isn't installed/activated yet, just follow the info and install/activate button in the admin notice that will appear
- Go to Settings > Toolbar Extras > General to set "Oxygen Builder" as your default Page Builder
- Now enjoy building your site with Oxygen Builder - and let the Toolbar work for you ;-)
For documentation and tutorials visit our Knowledge Base.
Frequently Asked Questions
Is Oxygen Builder required for this plugin?
Technically Oxygen Builder is not required. However, without Oxygen Builder being activated this Add-On plugin (Toolbar Extras for Oxygen Builder) doesn't make any sense at all.
I totally recommend Oxygen Builder - so, with it active, this plugin here will make the perfect sense, helping you save time, scrolling travel and getting you more productive.
Will other third-party Oxygen Plugins be supported?
Yes, absolutely. - Every Oxygen-specific plugin or Add-On will be supported as long as it has a settings page or comes with a post type screen or similar.
Why is the Administrator Role required?
This Add-On plugin only works and makes sense for Administrator users (and Super Admins in Multisite) just because the links it adds to the Toolbar normally do require those permissions for the original supported plugins.
Example: The Oxygen Builder settings page requires the capability manage_options
- by default, only Administrators have this capability. So Toolbar Extras for Oxygen Builder "inherits" those capabilities (permissions) as well.
So, to see anything added to the Toolbar, it is required the user must have the capabilities of manage_options
and edit_theme_options
. As long as these are in place, Toolbar Extras is the perfect companion! :-)
(Note: Implementing other roles/ capabilities is not planned, and it makes no sense, really. It would require the codebase to be bloated with all those additional permission conditions and would give only very very few (if any at all!) additional links for roles like "Editor" or lower. Again, offering all items only for Admins follows the supported integrations, prevents bloat and big footprint while also avoiding very high maintenance costs.)
Will this Plugin slow down my site?
Absolutely not. The plugin will only do its stuff for logged-in Administrator users. It does nothing for visitors of your site. And, the plugin loads its stuff only when needed and if supported third-party plugins are active. Plugin was built to be as lightweight as possible.
How can I disable the link attributes (tooltips)?
This is easily possible within the "General" settings of Toolbar Extras. Just go to the "General" tab and set options for the link behavior. -- Note: This setting also applies to the "Back to WP" section in Oxygen Builder interface itself.
Settings > Toolbar Extras > Tab: "General" > Section: "Links Behavior"
Where are more settings?
A lot more settings are available via the base plugin, Toolbar Extras. This opens up a lot of customization options and tweaks for you.
Does the Plugin work with the new Block Editor (Gutenberg)?
Yes, absolutely. Since the Toolbar has no direct connection to the editor anyways, it is fully compatible by default. Oxygen Builder and the Block Editor (Gutenberg) work totally fine together. And Toolbar Extras, the base plugin, also has special integration features for the Block Editor.
Does the Plugin work with Multisite?
Yes, it works fine in Multisite, you could even activate it Network-wide. However, it does add almost nothing additional to the Network Admin but rather to the Dashboard of each individual sub-site of the Network. Therefore I recommend to use "Toolbar Extras" only in single installs (default) currently.
More info on Translations?
- English - default, always included
- German (de_DE): Deutsch - immer dabei! :-)
- For custom and update-safe language files please upload them to
/wp-content/languages/toolbar-extras-oxygen/
(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 as well, just use a language file like toolbar-extras-oxygen-en_US.mo/.po
to achieve that (for creating one see the following tools).
Easy WordPress.org plugin translation platform with GlotPress platform: Translate "Toolbar Extras"...
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 and validating I recommend the awesome "Poedit Editor", which works fine on Windows, macOS and Linux.
Screenshots
1. Original Oxygen top-level item - now with customizable icon and label
2. Set Oxygen Builder as default builder in the "Build" Group
3. Oxygen Builder quick jump links for all its settings in Build Group
4. Oxygen Templates quick jump links in Build Group
5. Extensive official resources always at hand
6. Plus, awesome community resources always at hand
7. Optimizations for Oxygen Template Post Types in "New Content" Group
8. Optional Row Action "Edit with Oxygen" for a smarter, faster workflow
9. Optional Post State "Oxygen" for faster overview
10. Very handy "Reusable Parts" view filter for Oxygen Templates
11. Additional "Back to WP" links in Oxygen Builder's own Toolbar
12. Add-On plugin support baked right in
13. New "Oxygen" settings tab on Toolbar Extras settings page
14. Help tab for the Oxygen Add-On
15. Integrated Plugin Manager to easily install/activate all required, recommended and useful plugins
16. Site Health Debug Info screen with additional info (WP 5.2+)
17. Optional: List Oxygen Templates in the Toolbar
18. Settings & Customization for Templates Listing in Toolbar
19. Optional: List Oxygen-edited Pages in the Toolbar
20. Settings & Customization for Pages Listing in Toolbar
21. Oxygen WooCommerce Integration - via Toolbar Extras base plugin!
22. Oxygen Gutenberg Block Editor Integration - via Oxygen and Toolbar Extras base plugin!
23. Examples for supported Add-Ons - there are more, of course ;-)
Changelog
(For the full changelog of this plugin visit its website at ToolbarExtras.com)
π 1.2.0 - 2019-09-04
- New: Successfully tested with Oxygen Builder 3.0, including WooCommerce & Gutenberg Integrations
- New: Successfully tested with Oxygen Builder 2.4.1
- New: For Oxygen Template post type, added new optional Template Group as a top-level item, or as sub item in the Build Group - has lots of options for customizing
- New: For Oxygen-edited Pages, added new optional Pages Group as a top-level item, or as sub item in the Build Group - has lots of options for customizing
- New: Added plugin support for Oxygen Block Lab Support (free, by David Browne) - for Block Lab block templates
- New: Added plugin support for Oxygen EDD Support (free, by David Browne) - for Easy Digital Downloads (EDD) product & archive templates
- New: Added plugin support for Oxygen RCP Support (free, by David Browne) - for Restrict Content Pro content templates
- New: Added internal logic for settings updater between major versions of this Add-On
- Tweak: Added sub item for optional "Gutenberg" settings (Oxygen Gutenberg Integration)
- Tweak: For "My Custom Functionality" plugin support, added dynamic folder path detection to better handle GitHub specific scenarios
- Tweak: For some existing tweaks made sure they are not executed in the Oxygen Builder context to avoid any errors, warnings and notices
- Tweak: Added new screenshots (for the above new features)
- Tweak: Some under the hood improvements on code base
- Tweak: Updated
.pot
file plus all German translations (formal, informal) and language packs
- Fix: Fixed PHP notice if Oxygen Builder is still set as default page builder in settings but the plugin was deactivated meanwhile
- Note: The Add-On version 1.2.0 requires base plugin Toolbar Extras v1.4.6+
π 1.1.0 - 2019-05-16
- New: Successfully tested with Oxygen Builder 2.3
- New: Successfully tested with WordPress 5.2
- New: Added plugin support for "My Custom Functionality" (free, by Sridhar Katakam)
- New: Integrated with WordPress 5.2+ new Site Health feature: Toolbar Extras for Oxygen Builder now has an extra section on the Debug Info tab - this is especially helpful for support requests
- Tweak: Greatly improved the smart tweak for proper highlighting of parent file/ submenu for Oxygen Templates and User Elements Library (Block Library) as well
- Tweak: Improved all tweaks regarding Oxygen Templates post type labels
- Tweak: Plugin Manager admin notices are now properly dismissed - switched to notice library of Toolbar Extras base plugin :)
- Tweak: Minor compatibility tweaks for Oxygen 2.3 beta/RC/final releases
- Tweak: Updated
.pot
file plus all German translations (formal, informal) and language packs
- Note: The Add-On version 1.1.0 requires base plugin Toolbar Extras v1.4.3+
β‘ 1.0.2 - 2019-04-18
- Tweak: Setup Plugin Manager to load earlier to actually appear again
- Tweak: Small improvement to User Group link title attribute
- Tweak: Internal improvements and optimizations
- Tweak: Updated
.pot
file plus all German translations (formal, informal) and language packs
- Tweak: Enhanced and improved Readme.txt file here - also added new FAQ entry
- Fix: Proper Editor URL query params for templates to make all editable again - thanks to user feedback in Oxygen FB Group
- Fix: Correct admin URL on Plugins page listing
β‘ 1.0.1 - 2019-04-02
π 1.0.0 - 2019-04-02
- Plugin launch. Everything's new!
- New: Including support for 2 Oxygen-specific Add-On plugins
- New: New "Oxygen" tab on Toolbar Extras plugin settings page, with up to 16 different options
- New: Few tweaks for "Back to WP" links within Oxygen's own Toolbar in the Builder
- New: Post type item Row Action for "Edit with Oxygen"
- New: Post type item Post State for "Oxygen"
- New: 12 great Oxygen resources links integrated into the Toolbar
- Note: the Add-On integrates with current Oxygen Builder v2.2.1 as well as the upcoming v2.3.x release (tested with 2.3 alpha 1)
β‘ 0.9.0 - 2019-03-27
- New: Private beta release on GitHub
(For the full changelog of this plugin visit its website at ToolbarExtras.com)
Upgrade Notice
1.2.0
Oxygen 3.0+ compat! New Toolbar items for Oxygen Templates and Pages. Plus, 5 new Add-Ons supported. Bugs fixed, and more improvements, of course. - Update highly recommended! :-)
1.1.0
One more community extension supported. Plus great internal enhancements, fixes and optimizations. - Update highly recommended! :-)
1.0.2
Important maintenance release with internal fixes and optimizations. - Update highly recommended! :-)
1.0.1
Plugin launch. Everything's new! - Further fixes and optimizations. - Update highly recommended! :-)
1.0.0
Plugin launch. Everything's new!
0.9.0
Private beta.
βΊοΈ Donate
Enjoy using Toolbar Extras for Oxygen Builder? Please consider making a donation - every donation helps to support the project's continued development, maintenance and support.
Thank you very much in advance for your support!
Credits
Credit where credit is due. The following items were used, or used for inspiration for this plugin:
Additional Info
Idea Behind / Philosophy: Just a little lightweight plugin for all the Non-Coder site builders out there using Oxygen website builder - making their daily work and life just a little easier.
Last but not least
Special Thanks go out to my family for allowing me to do such spare time projects (aka free plugins) and supporting me in every possible way!
π My Other Plugins