This README documents whatever steps are necessary to get this plugin up and running.
Since version 3.0.0 CMB2 is used instead of the metabox.io plugin. Projects that have used earlier versions need to execute two commands from their terminal. If these commands are not executed there is a potential loss of data inside the meta table for all connected openpub-items.
When using the metabox.io plugin the value of meta field '_owc_openpub_highlighted_item' was '0' or '1'. CMB2 saves this value as 'on' or does not save a value at all when the checkbox is unchecked.
When using the metabox.io plugin the value of meta field '_owc_openpub_expirationdate' was a date + time (2023-02-20 00:00). CMB2 saves this value as a timestamp
- Download the latest release from the releases page
- Unzip and move all files to the
/wp-content/plugins/openpub-basedirectory. - Log into the WordPress admin and activate the 'Yard | OpenPub Base' plugin through the 'plugins' menu
- Go to the 'OpenPub instellingen' pagina in the left-hand menu to enter some of the required settings
To contribute to this project, no dependencies are required. However, you will need to download Composer to run tests or create an optimized build of the plugin.
- Clone this repository to your machine and/or WordPress installation
- Optionally use Composer (
composer install) to install the dev dependencies
To create an optimized and zipped build, run the composer run package command. This requires Composer, rsync and zip to run.
See Hooks
See REST API
To run the Unit tests go to a command-line.
# 1. go into the plugin directory
cd <path>
# 2. install the composer deps
composer install
# 3. run the tests
phpunitYou can run code coverage reports with the command below:
phpunit --coverage-html ./tests/coverageIf the OpenPub environment is shared by multiple websites and it is required to configure the websites where an openpub-item should be displayed on, follow the steps below:
Go to the 'OpenPub instellingen pagina' in the left-hand menu and look for the setting 'Show on'. Check the checkbox. When this setting is enabled this plugin creates a taxonomy 'Show on'.
Add terms to the taxonomy so the terms can be used in the editor of an openpub-item.
This plugin adds a select element to the editor of an openpub-item. Look for the select beneath the heading 'External' and select the websites you want this item to be displayed on.
The selected websites are now able to make requests to the items endpoint and only retrieve openpub-items which are intended for the selected website. Example url: https://url/wp-json/owc/openpub/v1/items?source={blog_slug}
All of the descriptions, labels and names inside this plugin can be translated since they are controlled by gettext methods. You can find the .pot file at in the languages directory.
Be careful not to put the translation files in a location which can be overwritten by a subsequent update of the plugin, theme or WordPress core.
Use your own preferred way of translating .pot files, however if this is your first time doing translations within WordPress, we recommend you use the Loco Translate plugin which is a great tool for translating WordPress plugins.
You're welcome to contribute or suggest improvements to this plugin. When you submit a pull request, please make sure all the tests pass.
Want to contribute but have no idea what to begin with? Take a look at the coverage reports to see where more coverage can be obtained.
You can ask technical questions at the GitHub issues page. For general questions about the Open Webconcept we ask you get in touch with us via the Open Webconcept website.