Ansible Role wordpress¶

This role installs and configures the WordPress CMS.

Attention: It is intended that when you call http://{wordpress__url}} you will get a white page because no theme is installed. http://{wordpress__url}}/wp-admin works as expected.

Mandatory Requirements¶

Install a web server (for example Apache httpd), and configure a virtual host for Nextcloud. This can be done using the linuxfabrik.lfops.apache_httpd role.
Install MariaDB 10+. This can be done using the linuxfabrik.lfops.mariadb_server role.
Install PHP 7+. This can be done using the linuxfabrik.lfops.php role.

If you use the WordPress Playbook, this is automatically done for you.

Tags¶

wordpress

Installs and configures wordpress.
Triggers: none.

wordpress:export

Exports the site content (posts, pages, comments, custom fields, categories and tags) as a wxr file.
Triggers: none.

wordpress:file_policy

chown -R --changes apache:apache {{ wordpress__install_dir }}.
restorecon -Fvr {{ wordpress__install_dir }}.
Triggers: none.

wordpress:update

Updates the WordPress core to wordpress__version. Also applies all DB migrations, and updates all plugins and themes.
Triggers: none.

Mandatory Role Variables¶

wordpress__admin_email

The Email of the WordPress admin user.
Type: String.

wordpress__admin_user

The WordPress admin user account.
Type: Dictionary.
Subkeys:
- username:
  - Mandatory. Username.
  - Type: String.
- password:
  - Mandatory. Password.
  - Type: String.

wordpress__database_user

The database user account with permissions on the wordpress__database_name database.
Type: Dictionary.
Subkeys:
- username:
  - Mandatory. Username.
  - Type: String.
- password:
  - Mandatory. Password.
  - Type: String.

wordpress__site_title

The WordPress site title.
Type: String.

wordpress__url

The WordPress URL, without http:// or https://.
Type: String.

Example:

# mandatory
wordpress__admin_email: 'webmaster@example.com'
wordpress__admin_user:
  username: 'wordpress-admin'
  password: 'linuxfabrik'
wordpress__database_user:
  username: 'wordpress'
  password: 'linuxfabrik'
wordpress__site_title: 'WordPress Test Site'
wordpress__url: 'wordpress.example.com'

Optional Role Variables¶

wordpress__database_host

The host on which the database is accessible.
Type: String.
Default: 'localhost'

wordpress__database_name

The name of the database.
Type: String.
Default: 'wordpress'

wordpress__disallow_file_edit

Prevent editing of plugin / theme files from the admin WebGUI. Strongly recommended to set this to true for security reasons.
Type: Bool.
Default: true

wordpress__install_dir

The installation directory for WordPress.
Type: String.
Default: '/var/www/html/{{ wordpress__url }}'

wordpress__plugins

List of WordPress plugin slugs. To get a list of already installed plugins, use the WordPress CLI sudo -u apache /usr/local/bin/wp plugin list --status=active.
Type: List of dictionaries.
Default: []
Subkeys:
- name:
  - Mandatory. Plugin slug, path to a local zip file, or URL to a remote zip file.
  - Type: String.
- state:
  - Optional. Either 'present' or 'absent'.
  - Type: String.
  - Default: 'present'

wordpress__theme

The WordPress theme to install. Accepts a theme slug, the path to a local zip file, or a URL to a remote zip file.
Type: String.
Default: unset

wordpress__version

The WordPress version to install. Possible options: version number, 'latest', 'nightly'.
Type: String.
Default: 'latest'

wordpress__wxr_export

Path to a WXR export file which will be imported after installing WordPress. The file includes posts, pages, comments, custom fields, categories and tags, and can be created using the wp-cli export function or the wordpress:export tag.
Type: String.
Default: unset

Example:

# optional
wordpress__database_host: 'localhost'
wordpress__database_name: 'wordpress'
wordpress__disallow_file_edit: true
wordpress__install_dir: '/var/www/html/{{ wordpress__url }}'
wordpress__plugins:
  - name: 'bbPress'
    state: 'present'
  - name: 'Akismet'
    state: 'absent'
wordpress__theme: 'twentysixteen'
wordpress__version: 'latest'
wordpress__wxr_export: '/tmp/wordpress.xml'

License¶

The Unlicense

Author Information¶

Linuxfabrik GmbH, Zurich