You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.markdown
+29-29Lines changed: 29 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
-
# Heroku buildpack: Wordpress on Heroku
1
+
# Heroku buildpack: WordPress on Heroku
2
2
3
-
### This is a Heroku buildpack for running [Wordpress](http://wordpress.org) on [Heroku](http://heroku.com)
3
+
### This is a Heroku buildpack for running [WordPress](http://wordpress.org) on [Heroku](http://heroku.com)
4
4
5
-
It uses this [Wordpress](http://github.com/mchung/wordpress-on-heroku) project template to bootstrap a highly tuned Wordpress site built on the following stack:
5
+
It uses this [WordPress](http://github.com/mchung/wordpress-on-heroku) project template to bootstrap a highly tuned WordPress site built on the following stack:
6
6
7
7
*`nginx` - Nginx for serving web content. Built specifically for Heroku. [See compile options](https://github.com/mchung/heroku-buildpack-wordpress/blob/master/support/package_nginx).
8
8
*`php` - PHP-FPM for process management. [See compile options](https://github.com/mchung/heroku-buildpack-wordpress/blob/master/support/package_php).
@@ -11,18 +11,18 @@ It uses this [Wordpress](http://github.com/mchung/wordpress-on-heroku) project t
11
11
*`Sendgrid` - Sendgrid for the email backend.
12
12
*`MemCachier` - MemCachier for the memcached backend.
13
13
14
-
You can see a live demo at [Wordpress on Heroku](http://wordpress-on-heroku.herokuapp.com).
14
+
You can see a live demo at [WordPress on Heroku](http://wordpress-on-heroku.herokuapp.com).
15
15
16
16
## Getting started in 60 seconds
17
17
18
-
Fork and rename the [Wordpress project template](http://github.com/mchung/wordpress-on-heroku).
18
+
Fork and rename the [WordPress project template](http://github.com/mchung/wordpress-on-heroku).
19
19
20
20
Let's clone the repository for a new blog, 99catfacts.com
> Don't have the Heroku Toolbelt installed? Follow these [quickstart instructions](https://devcenter.heroku.com/articles/quickstart). Takes about 2 minutes.
33
33
34
-
Deploy your Wordpress site to Heroku.
34
+
Deploy your WordPress site to Heroku.
35
35
```bash
36
36
$ git push heroku master
37
37
...
@@ -48,23 +48,23 @@ $ git push heroku master
48
48
-----> Launching... done, v7
49
49
```
50
50
51
-
Open your new Wordpress site in a web browser.
51
+
Open your new WordPress site in a web browser.
52
52
```bash
53
53
$ heroku apps:open
54
54
```
55
55
56
-
> Happy? Add your site to the growing [list of Wordpress sites runnning on Heroku](https://github.com/mchung/heroku-buildpack-wordpress/wiki/Sites-running-Wordpress-on-Heroku).
56
+
> Happy? Add your site to the growing [list of WordPress sites runnning on Heroku](https://github.com/mchung/heroku-buildpack-wordpress/wiki/Sites-running-Wordpress-on-Heroku).
57
57
58
58
## Overview
59
59
60
-
The buildpack bootstraps a Wordpress site using the [mchung/wordpress-on-heroku](http://github.com/mchung/wordpress-on-heroku) project template. That repo contains everything required to run your own Wordpress site on Heroku.
60
+
The buildpack bootstraps a WordPress site using the [mchung/wordpress-on-heroku](http://github.com/mchung/wordpress-on-heroku) project template. That repo contains everything required to run your own WordPress site on Heroku.
61
61
62
-
There are several files available in `config` for configuring your new Wordpress site.
62
+
There are several files available in `config` for configuring your new WordPress site.
63
63
64
64
```
65
65
└── config # Your config files goes here.
66
66
├── public # The public directory
67
-
│ └── wp-content # Wordpress themes and plugins
67
+
│ └── wp-content # WordPress themes and plugins
68
68
│ ├── plugins
69
69
│ └── themes
70
70
└── vendor # Config files for vendored apps
@@ -74,9 +74,9 @@ There are several files available in `config` for configuring your new Wordpress
74
74
└── etc # php.ini & php-fpm.conf
75
75
```
76
76
77
-
When you deploy Wordpress to Heroku, everything in `config` is copied over to Heroku. You can configure your blog by making changes to these files.
77
+
When you deploy WordPress to Heroku, everything in `config` is copied over to Heroku. You can configure your blog by making changes to these files.
78
78
79
-
A few Wordpress environment variables can be controlled via Heroku using `heroku config:set`:
79
+
A few WordPress environment variables can be controlled via Heroku using `heroku config:set`:
80
80
81
81
*`FORCE_SSL_LOGIN`
82
82
*`FORCE_SSL_ADMIN`
@@ -87,23 +87,23 @@ A few Wordpress environment variables can be controlled via Heroku using `heroku
87
87
88
88
> To add a Heroku environment variable: `heroku config:set GOOG_UA_ID=UA=1234777-9`
89
89
90
-
See `wp-config.php` and documentation from Wordpress for details.
90
+
See `wp-config.php` and documentation from WordPress for details.
91
91
92
-
Enabling and configuring the following Wordpress plugins will also speed up Wordpress on Heroku significantly.
92
+
Enabling and configuring the following WordPress plugins will also speed up WordPress on Heroku significantly.
93
93
94
94
*`heroku-sendgrid` - Configures phpmailer to send SMTP email with Sendgrid.
95
-
*`heroku-google-analytics` - Configures Google Analytics to display on your Wordpress site.
95
+
*`heroku-google-analytics` - Configures Google Analytics to display on your WordPress site.
96
96
* GOOG_UA_ID=UA-9999999
97
-
*`wpro` - Configures Wordpress to upload everything to S3.
98
-
*`batcache` - Configures Wordpress to use memcached for caching.
97
+
*`wpro` - Configures WordPress to upload everything to S3.
98
+
*`batcache` - Configures WordPress to use memcached for caching.
99
99
*`memcachier` - Use a modern memcached plugin.
100
100
*`cloudflare` - OPTIONAL, but very awesome.
101
-
* If Cloudflare is installed, the plugin configures Wordpress to play nicely with CloudFlare. It sets the correct IP addresses from visitors and comments, and also protects Wordpress from spammers.
101
+
* If Cloudflare is installed, the plugin configures WordPress to play nicely with CloudFlare. It sets the correct IP addresses from visitors and comments, and also protects WordPress from spammers.
102
102
* Keep in mind that the free version doesn't support SSL, so you'll need to set both `FORCE_SSL_ADMIN` and `FORCE_SSL_LOGIN` to false in order to login.
Use the [Wordpress.org secret-key service](https://api.wordpress.org/secret-key/1.1/salt/) to override the default ones in `wp-config.php`.
147
+
Use the [WordPress.org secret-key service](https://api.wordpress.org/secret-key/1.1/salt/) to override the default ones in `wp-config.php`.
148
148
149
149
### Configuring cron
150
150
By default, wp-cron is fired on every page load and scheduled to run jobs like future posts or backups. This buildpack disables wp-cron so that visitors don't have to wait to see the site.
### Choosing specific versions of vendored packages
193
193
194
-
See [VERSIONS](VERSIONS.md) for how to pick specific versions of Nginx, PHP, and Wordpress
194
+
See [VERSIONS](VERSIONS.md) for how to pick specific versions of Nginx, PHP, and WordPress
195
195
196
196
### Workflow (optional)
197
197
198
-
By keeping your changes separate, it'll be easier to pull in changes from the Wordpress site template.
198
+
By keeping your changes separate, it'll be easier to pull in changes from the WordPress site template.
199
199
200
200
Assign a remote `upstream`
201
201
```bash
@@ -228,7 +228,7 @@ Pretty freaking fast.
228
228
229
229
System setup
230
230
* Single Heroku dyno
231
-
* Default Wordpress installation
231
+
* Default WordPress installation
232
232
* Default twentytwelve theme
233
233
* Caching turned up
234
234
* Cron disabled
@@ -258,7 +258,7 @@ Over 200 page views per second with less than 100ms response time sustained for
258
258
259
259
[See the WebPageTest report](http://www.webpagetest.org/result/130201_BB_624/)
260
260
261
-
These tests are periodically rerun on [Wordpress on Heroku](http://wordpress-on-heroku.herokuapp.com).
261
+
These tests are periodically rerun on [WordPress on Heroku](http://wordpress-on-heroku.herokuapp.com).
262
262
263
263
## But doesn't Heroku only run Ruby applications?
264
264
@@ -273,15 +273,15 @@ The [ephemeral filesystem](http://devcenter.heroku.com/articles/dyno-isolation)
273
273
274
274
## Security disclosure
275
275
276
-
Each time Wordpress is deployed, Heroku will fetch the latest buildpack from GitHub and execute the instructions in `compile` and `deploy`. This buildpack will download the latest precompiled versions of Nginx, PHP, and Wordpress from my personal [S3 bucket](http://heroku-buildpack-wordpress.s3.amazonaws.com) then add in config files from the [`config`](https://github.com/mchung/wordpress-on-heroku/tree/master/config) directory.
276
+
Each time WordPress is deployed, Heroku will fetch the latest buildpack from GitHub and execute the instructions in `compile` and `deploy`. This buildpack will download the latest precompiled versions of Nginx, PHP, and WordPress from my personal [S3 bucket](http://heroku-buildpack-wordpress.s3.amazonaws.com) then add in config files from the [`config`](https://github.com/mchung/wordpress-on-heroku/tree/master/config) directory.
277
277
278
278
## Hacking and Contributing
279
279
280
280
Not comfortable downloading and running a copy of someone else's PHP or Nginx executables? Not a problem! The `support` directory also contains a handful of compilation and deployment scripts to automate several processes, which are currently used for maintenance and repo management.
281
281
282
282
*`package_nginx` - Used to compile and upload the latest version of Nginx to S3.
283
283
*`package_php` - Used to compile and upload the latest version of PHP to S3.
284
-
*`wordup` - Really useful helper script for creating and destroying Wordpress sites.
284
+
*`wordup` - Really useful helper script for creating and destroying WordPress sites.
285
285
286
286
## TODO
287
287
@@ -300,7 +300,7 @@ Not comfortable downloading and running a copy of someone else's PHP or Nginx ex
300
300
301
301
Thanks for reading this all the way through.
302
302
303
-
If you use this buildpack in production, please update the [list of Wordpress sites running on Heroku](https://github.com/mchung/heroku-buildpack-wordpress/wiki/Sites-running-Wordpress-on-Heroku).
303
+
If you use this buildpack in production, please update the [list of WordPress sites running on Heroku](https://github.com/mchung/heroku-buildpack-wordpress/wiki/Sites-running-Wordpress-on-Heroku).
0 commit comments