Update download redirect url for bundles
[blender-org.git] / README.md
1 # blender.org WordPress Theme
2
3 'bthree' is the WordPress theme of blender.org's main website. We invite web developers to help and provide fixes.
4 Join the discussion on the [dedicated mailing list](http://lists.blender.org/mailman/listinfo/bf-webcontent).
5
6 ## Installation
7
8 1. Get a copy of [WordPress](https://wordpress.org/)
9 2. Extract the archive in your local Apache server
10 3. Delete the `wp-content` folder
11 4. Check out this repository as `wp-content` as a replacement for the just deleted folder
12 6. Create a new MySQL database 'wp_www'
13 7. Import the database content (links below)
14 5. Move the upload folder to /wp-content/ (links below)
15 8. Configure your `wp-config.php` file to use this database
16
17
18 ## Docker Notes
19
20 Example `docker-compose.yaml`, the `volumes` section is needed to override `wp-config.php` and the entire `wp-content` folder.
21
22 ```
23   wordpress:
24     image: wordpress
25     container_name:          wordpress
26     restart: always
27     ports:
28       - 8080:80
29     volumes:
30       - /home/<local_install_path>/wordpress/wp-content:/var/www/html/wp-content
31       - /home/<local_install_path>/wordpress/wp-config.php:/var/www/html/wp-config.php
32 ```
33
34 Remember to set the user:group (so you can e.g. update plugins):
35
36 1. `docker exec -ti wordpress bash`
37 2. `chown -R www-data:www-data /var/www`
38
39
40 ## Links
41
42 - [Database dump](https://www.dropbox.com/s/vdf71y187f8khip/wp_www.sql.gz?dl=1)
43 - [Uploads folder](https://www.dropbox.com/s/ddm3rzdlgyum6pn/uploads.zip?dl=1)
44
45
46 ## Other info
47
48 - WP username and password are: admin, password
49 - If you can add to your `/etc/hosts` file the following line:
50
51 ```
52 local.blender.org       120.0.0.1
53 ```
54 so that you can visit local.blender.org on your browser and see the website. Alternatively you can add to your `wp-config.php` the following lines to see it visiting localhost/blender:
55
56 ```
57 define('WP_HOME','http://localhost/blender');
58 define('WP_SITEURL','http://localhost/blender');
59 ```
60
61 ## Apache settings
62 Depending on the system you are working on, you might want to check these settings too:
63
64 1. enable short_code (in php.ini)  - this allows code to run with "<?" as well as <?php". The template and plugins use both formats.
65 2. enable "rewrite_module" or "mod_rewrite" - this allow the links to work since the permalink format is different than the default.
66
67
68 ## Plugins currently used
69 - [Advanced Custom Fields](http://www.advancedcustomfields.com/) (some areas use the add-on 'Repeater Field')
70 - [CMS Tree Page View](http://eskapism.se/code-playground/cms-tree-page-view/)
71 - Google XML Sitemaps
72 - HTML Editor Syntax Highlighter
73 - [iframe](http://web-profile.com.ua/wordpress/plugins/iframe/)
74 - Media Library Assistant
75 - Page Links To
76 - Post Snippets
77 - [Redirection](https://wordpress.org/plugins/redirection/)
78 - W3 Total Cache
79 - [Widgetable](http://halgatewood.com/widgetable)
80 - WP RSS Aggregator
81
82
83 ## Production Deploy Playbook
84
85 - Login to blender.org as borg
86 - `cd /data/www/vhosts/code.blender.org/wordpress/wp-content/themes/`
87 - `git pull`
88 - `sudo apachectl graceful`
89 - Logout
90 - Additionally, to push assets, run `./deploy.sh blender.org`