stats4sd/ccrp_soils_wp

The WordPress Site for the Soils Health Toolkit / Kobotoolbox link app.

CCRP Soils WordPress

The WordPress Site for the Soils Health Toolkit / Kobotoolbox link app.

Structure / Tech setup

The main wordpress site, along with some plugins and themes, is all installed and maintained via Composer - thanks to (johnpbloch)[https://github.com/johnpbloch] for their composer-enabled WordPress repository.

The site uses the excellent (DataTables)[datatables.net] jQuery plugin to present data from the custom mySQL schema that holds the users' soils data. We also use the propriatory Editor addon to Datatables to handle write operations to the database. Both Datatables and the Editor are bundled into a custom WordPress plugin, which is installed via Composer from the Stats4SD BitBucket account. The Datatables plugin is stored on BitBucket as we need to keep it private given the propriatory code in use.

todo - setup a public version of the plugin, with instructions on where to put the Editor files, so users with a licence can take a copy.

This site also has a custom plugin (ccrp-soils) and theme (currently a child of the (Bootstrap Starter)[https://en-gb.wordpress.org/themes/wp-bootstrap-starter/], but likely to change soon). These custom plugins are included in this repository.

Cloning for local development

To setup the dependancies locally, you need to have both Composer and Yarn installed on your computer.

Cloning onto a server

Check your package managers are installed

Installing the dependancies requires composer and yarn. Make sure you have them both installed composer instructions; for yarn, run npm install -g yarn (though there's discussion about whether installing via npm is good practice or not....

Clone this repo and install dependancies

1. git clone into your webroot folder.
2. cd into your new repo folder and run composer install.
3. check logs to ensure that post-install scripts were run.

• includes installing dependancies for other plugins
• includes updating index.php with new path.

4. Set permissions correctly, so WordPress can write to uploads etc.:

• sudo chown www-data:www-data /path/to/git/repo -R
• sudo mkdir /path/to/git/repo/content/uploads
• sudo chown www-data:www-data /path/to/git/repo/content/uplaods -R
• sudo chmod 755 /path/to/git/repo/content/uploads -R

Setup WordPress

1. Copy the wp-config-sample.php to wp-config.php and add your own config settings. This already has some customisations from the default config file to tell WP where our content is.
2. Secure wp-config with permissions:

• sudo chown www-data:www-data /path/to/git/repo/wp-config.php
• sudo chmod 600 /path/to/git/repo/wp-config.php.

2. Setup the WordPress database.

• If starting from scratch, navigate to your new site through a browser and create the db using the 'famous five-minute WordPress Installation process'.
• If you're bringing a database over from another install, I suggest the 'duplicator' plugin. I've had a lot of success moving wordpress databases around with that one. Make sure that when you create the duplicator backup, you choose 'database only' mode.