BasePress Knowledge Base + Oxygen Visual Site Builder Integration
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.
After installing and activating the plugin you should:
1. Create a new dedicated template in Oxygen for your Knowledge Base.
2. In the newly created template select the “Knowledge Base” post type under Single and “All Knowledge Base categories” under Archive. Remove any other option from the template.
3. Edit the Template content clicking “Edit with Oxygen” and just add the shortcode [basepress-oxygen].
4. Visit BasePress settings and under “Aspect” tick the option “Skip loading of header and footer”.
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.
Upload the plugin files to the
/wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress.
The plugin has no settings
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.