readme.txt

=== 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 :-).

https://www.youtube.com/watch?v=jmvFqH9pqrA

ℹ️ **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 =
* *Official:* **Oxygen Gutenberg Integration** (Premium, by Soflyy) -- For the Block Editor
* *Official:* **Oxygen Elements for WooCommerce** (Premium, by Soflyy)
* [**Oxygens Swiss Knife** (free, by Marko Krstic)](https://github.com/krstivoja/Oxygens-Swiss-Knife)
* [**Oxygen Theme Enabler** (free, by Sridhar Katakam)](https://github.com/srikat/oxygenthemeenabler) -- **Note:** The settings of this Add-On will be considered for Toolbar items! ;-)
* [**Builder Template Categories** (free, by David Decker - DECKERWEB)](https://wordpress.org/plugins/builder-template-categories/)
* [**My Custom Functionality** (free, by Sridhar Katakam)](https://github.com/srikat/my-custom-functionality)
* [**Oxygen Block Lab Support** (free, by David Browne)](https://github.com/wplit/oxygen-block-lab-support)
* [**Oxygen EDD Support** (free, by David Browne)](https://github.com/wplit/Oxygen-EDD-Support)
* [**Oxygen RCP Support** (free, by David Browne)](https://github.com/wplit/Oxygen-RCP-Support)

= 👉 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)](https://translate.wordpress.org/locale/de/default/wp-plugins/toolbar-extras-oxygen) - `de_DE`
* 🇩🇪 [German (formal)](https://translate.wordpress.org/locale/de/formal/wp-plugins/toolbar-extras-oxygen) - `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](https://translate.wordpress.org/projects/wp-plugins/toolbar-extras-oxygen).

You can also contribute code-wise via our [Toolbar Extras for Oxygen Builder GitHub Repository](https://github.com/deckerweb/toolbar-extras-oxygen) - and see where you can help.

= 📝 Documentation and Support =
* For more information about features, FAQs and documentation, check out our website at [Toolbar Extras for Oxygen Builder Plugin](https://toolbarextras.com/).
* If you have any more questions, visit our support on the [Plugin's Forum](https://wordpress.org/support/plugin/toolbar-extras-oxygen).
* An overview about the ongoing development you'll find on our [Trello Board for the Plugin's Roadmap](https://trello.com/b/JrpjwlX4/toolbar-extras-public-roadmap)

= ⚡ Liked Toolbar Extras for Oxygen Builder Plugin? =
* Join our [Facebook Community Group 💬](https://www.facebook.com/groups/ToolbarExtras/)
* **Rate us 5 ⭐ stars** on [WordPress.org](https://wordpress.org/support/plugin/toolbar-extras-oxygen/reviews/?filter=5/#new-post) :)
* [**Subscribe to my Newsletter for insider info on this plugin** 💯](https://eepurl.com/gbAUUn), plus tutorials and more stuff on deckerweb WordPress plugins - join a thriving community of site builders!
* [**Become a Patron** 💜](https://www.patreon.com/deckerweb) and support ongoing development, maintenance and support of this plugin
* [**Follow us on Instagram** 📷](https://www.instagram.com/toolbarextras) and like our content
* Follow us on Twitter 🐦: [@ToolbarExtras](https://twitter.com/toolbarextras) and [@deckerweb](https://twitter.com/deckerweb)

= ☕ This Plugin ... =
* ... scratches my own itch!
* ... is *Quality Made in Germany*
* ... was created with love (plus some coffee) :-) - [if you like it consider donating](https://www.paypal.me/deckerweb)


== Installation ==

= Minimum Requirements =

* **Base plugin:** [Toolbar Extras](https://wordpress.org/plugins/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 =

https://www.youtube.com/watch?v=NrYj72Lpdww

1. 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.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. 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
4. Go to **Settings > Toolbar Extras > tab "General"** to set "Oxygen Builder" as your **default** Page Builder
5. Now enjoy building your site with Oxygen Builder - and let the Toolbar work for you ;-)

For documentation and tutorials visit our [Knowledge Base](https://toolbarextras.com/docs/).


== 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. That means, without Oxygen active, no items, settings etc. will be loaded at all.

I totally [recommend Oxygen Builder](https://toolbarextras.com/go/oxygen/) - 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.)


= Why has the base plugin "Toolbar Extras" the word "Elementor" in its title? =
That is only in the plugin's readme and therefore appears on the plugin page on wordpress.org. The reason is simple: the "Elementor Add-On" is de-facto built-in in the base plugin and not an extra Add-On (like this one here for Oxygen). But don't worry: you won't see any Elementor stuff ever. Those integrations are only ever loaded at all if Elementor is installed and active.

So don't get confused :-) On your "Plugins" page in your WordPress install the base plugin is listed normally as just "Toolbar Extras" and that is also the official name and it is referenced everywhere as that only.

For more background info on this topic have look on our website:

* *Blog post:* [Can Toolbar Extras be Used Without Elementor? (or Plugin/ Theme Xyz?)](https://toolbarextras.com/use-toolbar-extras-without-elementor/)
* *Documentation article:* [Why is Toolbar Extras required and why no standalone plugin?](https://toolbarextras.com/docs/addons-why-toolbar-extras-required/)


= 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"...**](https://translate.wordpress.org/projects/wp-plugins/toolbar-extras-oxygen)

*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"](https://www.poedit.net/), 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

22. Oxygen Gutenberg Block Editor Integration

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](https://toolbarextras.com/changelog/))


= 🎉 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)](https://github.com/wplit/oxygen-block-lab-support) - for *Block Lab* block templates
* New: Added plugin support for [Oxygen EDD Support (free, by David Browne)](https://github.com/wplit/Oxygen-EDD-Support) - for *Easy Digital Downloads (EDD)* product & archive templates
* New: Added plugin support for [Oxygen RCP Support (free, by David Browne)](https://github.com/wplit/Oxygen-RCP-Support) - 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
* 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)](https://toolbarextras.com/addons/oxygen-builder/#tab-screenshots)
* 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+](https://wordpress.org/plugins/toolbar-extras/)


= 🎉 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)](https://github.com/srikat/my-custom-functionality)
* 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+](https://wordpress.org/plugins/toolbar-extras/)


= ⚡ 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](https://www.facebook.com/groups/1626639680763454/)
* Fix: Correct admin URL on Plugins page listing


= ⚡ 1.0.1 - 2019-04-02 =
* New: [Video of plugin walkthrough and live demo](https://www.youtube.com/watch?v=jmvFqH9pqrA)
* New: [Video of Add-On installation & activation, plus setting the first important setting](https://www.youtube.com/watch?v=NrYj72Lpdww)
* Tweak: Further performance optimization to load as minimal stuff as possible
* Tweak: Updated `.pot` file plus all German translations (formal, informal) and language packs
* Fix: Fixed fatal error on activation (sorry!)


= 🎉 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](https://toolbarextras.com/changelog/))


== 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](https://www.paypal.me/deckerweb)** - 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:

* Oxygen "O" logo/icon and "OXYGEN" logo [courtesy of Soflyy](https://oxygenbuilder.com/)
* JavaScript for link additions for "Back to WP" section in Oxygen inspired by [plugin "Back to Oxygen Templates"](https://github.com/srikat/back-to-oxygen-templates) by [Sridhar Katakam](https://wpdevdesign.com/) (GPLv2 or later)


== 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 ==
* [**Toolbar Extras for Elementor & More - WordPress Admin Bar Enhanced**](https://wordpress.org/plugins/toolbar-extras/)
* [**Toolbar Extras for MainWP Dashboard - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-mainwp/)
* [**Toolbar Extras for Give Donations (GiveWP) - Add-On plugin**](https://wordpress.org/plugins/toolbar-extras-givewp/)
* [**Builder Template Categories - for WordPress Page Builders**](https://wordpress.org/plugins/builder-template-categories/)
* [**Polylang Connect for Elementor – Language Switcher & Template Tweaks**](https://wordpress.org/plugins/connect-polylang-elementor/)
* [**Simple Download Manager for WP Document Revisions**](https://wordpress.org/plugins/wpdr-simple-downloads/)
* [Genesis What's New Info](https://wordpress.org/plugins/genesis-whats-new-info/)
* [Genesis Layout Extras](https://wordpress.org/plugins/genesis-layout-extras/)
* [Genesis Widgetized Not Found & 404](https://wordpress.org/plugins/genesis-widgetized-notfound/)
* [Genesis Extra Settings Transporter](https://wordpress.org/plugins/genesis-extra-settings-transporter/)
* [Genesis Widgetized Footer](https://wordpress.org/plugins/genesis-widgetized-footer/)
* [Genesis Widgetized Archive](https://wordpress.org/plugins/genesis-widgetized-archive/)
* [Multisite Toolbar Additions](https://wordpress.org/plugins/multisite-toolbar-additions/)
* [Cleaner Plugin Installer](https://wordpress.org/plugins/cleaner-plugin-installer/)
* [*My plugins newsletter*](https://eepurl.com/gbAUUn)