Installing MolPress requires access to the filesystem of a functioning WordPress installation and git. At the present time, periodically refreshing new versions from GitHub is recommended, since the project is in its early stages. The instructions presume a Unix (Linux/macOS) system, but adaption to Windows should be straightforward.

Downloading

Change directory to the plugins directory, e.g.

cd /var/www/wordpress/wp-content/plugins

Create a new directory for MolPress:

mkdir molpress
cd molpress

Initialise Git and pull from the repository:

git init
git remote add origin https://github.com/aclarkxyz/web_molpress.git
git pull origin master

This will fill up the directory with all of the relevant content. The GitHub synchronisation is read only, so you don’t have to worry about modifying anything. Whenever a new version comes out, you can return to the molpress plugin directory and type git pull origin master to acquire the latest content.

Configuration

One of the necessary capabilities is the ability to allow content editors to upload chemical datafiles. Some small files can be embedded within individual pages (e.g. molecules), but collections generally need to be stored as separate files. By default, WordPress only allows a handful of media types. If this has not already been done, you need to edit the configuration file (e.g. /var/www/wordpress/wp-config.php) and add the line:

define('ALLOW_UNFILTERED_UPLOADS', true);

Check to make sure it has not already been added.

Activation

Before the plugin does anything, you need to go through the WordPress administration UI: find the Plugins section, locate the MolPress plugin within the list, and Active it:

After this, you should have a functioning plugin. Read on to see how the objects work.