OpenPub WOO Portal Plugin

This plugin adds a custom endpoint to your OpenPub installation that can be used to display the WOO Portal in a WordPress website.

Requirements

OpenPub

In order to make this plugin work, you will need to have a OpenPub installation with at least the following installed (and activated):

• WordPress
• CMB2
• OpenPub Base
• OpenWoo
• OpenConvenanten
• OpenPub Portal

On this OpenPub installation you will have to enable pretty permalinks (Settings > Permalinks > Select any of the options that is not plain). And under Settings > OpenPub Portal, you will need to fill in the portal url.

WOO Portal

Now you have set up your OpenPub installation, you can set up the WOO Portal. There are three possible setups for the WOO Portal, this can be:

1. On the WordPress installation of an existing website.
2. On the same installation as the OpenPub.
3. On a completely new WordPress installation.

In all three scenarios the WOO Portal needs to have the following installed (and activated):

• WordPress
• CMB2
• Woo Portal Plugin

With this installed you can use the WOO Portal Search block on any page of your WordPress website. With this block there are several settings that need to be set in order for the block to work correctly.

If you chose for option 2 (same installation as the OpenPub) or option 3 (new WordPress installation), you will probably need to install a WordPress theme.. You can use the WOO Portal Theme, which is a simple theme for a WOO Portal. This theme provides several settings:

• Under Appearance > Customize > WOO Portal Theme, you can set the WOO Portal Colors.
• Under Theme Options there are several settings that need to be set.

Installation

Manual installation

1. Upload the opepub-woo-portal folder to the /wp-content/plugins/ directory.
2. Activate the OpenPub WOO Portal plugin through the 'Plugins' menu in WordPress.

Composer installation

1. composer source git@github.com:OpenWebconcept/plugin-openpub-woo-portal.git
2. composer require acato/openpub-woo-portal
3. Activate the OpenPub WOO Portal plugin through the 'Plugins' menu in WordPress.

Development

Coding Standards

Please remember, we use the WordPress PHP Coding Standards for this plugin! (https://make.wordpress.org/core/handbook/best-practices/coding-standards/php/) To check if your changes are compatible with these standards:

• cd /wp-content/plugins/openpub-woo-portal
• composer install (this step is only needed once after installing the plugin)
• ./vendor/bin/phpcs --standard=phpcs.xml.dist .
• See the output if you have made any errors.
  • Errors marked with [x] can be fixed automatically by phpcbf, to do so run: ./vendor/bin/phpcbf --standard=phpcs.xml.dist .

N.B. the composer install command also install a git hook, preventing you from committing code that isn't compatible with the coding standards.

Translations

wp i18n make-pot . languages/openpub-woo-portal.pot --exclude="node_modules/,vendor/" --domain="openpub-woo-portal"