blender.org WordPress Theme

'bthree' is the WordPress theme of blender.org's main website. We invite web developers to help and provide fixes.

Reporting issues and pull requests are welcome in the project page.

Installation

1. Install WordPress locally (use blender.local as URL)
2. Delete the wp-content folder
3. git clone this repository as a wp-content folder
4. cd wp-content
5. git submodule init
6. git submodule update
7. npm install to install dependencies.
8. npm run copy to copy fonts and icons from assets_shared into the assets folder.
9. npm run build to finally build all stylesheets and javascript.

Development

Run npm start in the root of the repo, this will to open blender.local:3000 in your browser and refresh automatically on changes.

Required Plugins

• ACF Pro

Installation Notes

Docker

If you choose to install WordPress via Docker, the volumes section is needed to override wp-config.php and the entire wp-content folder.

Example docker-compose.yaml:

  wordpress:
    image: wordpress
    container_name:          wordpress
    restart: always
    ports:
      - 8080:80
    volumes:
      - /home/<local_install_path>/wordpress/wp-content:/var/www/html/wp-content
      - /home/<local_install_path>/wordpress/wp-config.php:/var/www/html/wp-config.php

Remember to set the user:group (so you can e.g. update plugins):

1. docker exec -ti wordpress bash
2. chown -R www-data:www-data /var/www

Apache

If you choose to install WordPress using Apache, you might want to check these settings:

1. Enable short_code (in php.ini) - this allows code to run with "<?" as well as <?php". The template and plugins use both formats.
2. Enable "rewrite_module" or "mod_rewrite" - this allow the links to work since the permalink format is different than the default.

Production Deploy Playbook

• Login to blender.org as borg
• cd /data/www/vhosts/code.blender.org/wordpress/wp-content/themes/
• git pull
• sudo apachectl graceful
• Logout
• Additionally, to push assets, run ./deploy.sh blender.org