BasePress Knowledge Base + Oxygen Visual Site Builder Integration

Omschrijving

BasePress is the best option when it comes to building advanced knowledge bases on your WordPress site.
If you use Oxygen site builder to create your posts and pages this add-on is what you are looking for to integrate BasePress Knowledge Base and Oxygen builder!

Why is this plugin necessary?

BasePress was developed to integrate with your WordPress theme and it uses its own templates to display the knowledge base content.
On the other hand Oxygen builder disables any WordPress theme as it doesn’t need one to work and uses its own templates to display your site. In doing so it overrides BasePress templates.

This small plugin adds a new shortcode that can be used inside Oxygen’s templates making BasePress work as expected with Oxygen.

How to use

  1. Set-up BasePress as normal
  2. Create a new dedicated template in Oxygen for your Knowledge Base.
  3. In the newly created template select the template you want the knowledge base to inherit in “INHERIT DESIGN FROM OTHER TEMPLATE”.
  4. Select the “Knowledge Base” post type under Single
  5. Select “All Knowledge Base categories” under Archive > Taxonomies.
  6. Remove any other option from the template.
  7. Set the template priority higher than other templates.
  8. Edit the Template content by clicking “Edit with Oxygen” and just add the shortcode [basepress-oxygen].

If you need to customise a BasePress theme or create your own you can still follow the instructions in these articles:
Customise a knowledge base theme
Create a new knowledge base theme
Just keep in mind that Oxygen would disable any theme in your WordPress installation therefore you cannot place BasePress custom theme on your WordPress theme’s folder.
You can instead place the custom BasePress theme in WordPress uploads directory.

Installatie

  1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. The plugin has no settings

FAQ

Does this work with all BasePress versions?

This plugin works with BasePress version 2.4.1 or newer

When I view the knowledge base pages, the header and footer are not displaying correctly

BasePress uses by default your theme’s header and footer. Because Oxygen builder disables any theme and therefore the theme’s header and footer this would not work with the default BasePress behaviour.
Just visit BasePress Settings > Aspect and enable “Skip loading of header and footer”. This will make the knowledge base pages display correctly inside Oxygen template.

Beoordelingen

10 juni 2020
This works like a charm! I recently switched a clients website to Oxygen Builder that is using Basepress for their knowledge base and I'm so glad you guys had already created a solution! Keep up the good work and thanks!
Lees 1 beoordeling

Bijdragers & ontwikkelaars

“BasePress Knowledge Base + Oxygen Visual Site Builder Integration” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

Changelog

1.0.1

  • Automatically disable BasePress loading of header and footer

1.0.0

  • First release