README

This README documents whatever steps are necessary to get this plugin up and running.

Getting started

Installation

For users

1. Download the latest release from the releases page
2. Unzip and move all files to the /wp-content/plugins/pdc-samenwerkende-catalogi directory.
3. Log into the WordPress admin and activate the 'PDC Samenwerkende Catalogi' plugin through the 'plugins' menu
4. Go to the 'PDC instellingen pagina' in the left-hand menu to enter some of the required settings

For developers

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.

1. Clone this repository to your machine and/or WordPress installation
2. 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.

Filters & Actions

There are various hooks, which allows for changing the output.

Action for changing main Plugin object.

'owc/pdc-samenwerkende-catalogi/plugin'

See OWC\PDC\Base\Foundation\Config->set method for a way to change this plugins config.

Via the plugin object the following config settings can be adjusted

• settings

Translations

If you want to use your own set of labels/names/descriptions and so on you can do so. All text output in this plugin is controlled via the gettext methods.

Please use your preferred way to make your own translations from the /wp-content/plugins/pdc-samenwerkende-catalogi/languages/pdc-samenwerkende-catalogi.pot file

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.

We recommend using the 'Loco Translate' plugin. https://wordpress.org/plugins/loco-translate/

This plugin provides an easy interface for custom translations and a way to store these files without them getting overwritten by updates.

For instructions how to use the 'Loco Translate' plugin, we advice you to read the Beginners's guide page on their website: https://localise.biz/wordpress/plugin/beginners or start at the homepage: https://localise.biz/wordpress/plugin

Running tests

To run the Unit tests go to a command-line.

cd /path/to/wordpress/htdocs/wp-content/plugins/pdc-samenwerkende-catalogi/
composer install
composer unit

For code coverage report, generate report with command line command and view results with browser.

composer unit-coverage

Contribution guidelines

Writing tests

Have a look at the code coverage reports to see where more coverage can be obtained. Write tests. Create a Pull request to the OWC repository.

Who do I talk to?

If you have questions about or suggestions for this plugin, please contact Holger Peters from Gemeente Buren.