forked from GoogleCloudPlatform/wordpress-plugins
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
138 lines (100 loc) · 5.18 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
=== Google App Engine for WordPress ===
Contributors: google, sennza
Tags: google, app engine, gae, mail, email, uploads, uploading, cloud storage
Requires at least: 3.5
Tested up to: 4.0
Stable tag: 1.5
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Optimize your WordPress installation for the Google App Engine platform.
== Description ==
Google App Engine for WordPress enables seamless operation of your
WordPress-powered site on the App Engine PHP runtime.
This plugin adds overrides to core functionality in WordPress to use App Engine
infrastructure, such as the Mail functionality, and uploading media to Google
Cloud Storage
= Note: This plugin is designed to be used with Google App Engine only and will not work with any other hosting. =
== Installation ==
This plugin should be downloaded and placed in your `/wp-content/plugins/`
directory. The App Engine infrastructure does not allow you to install plugins
and themes without deploying them via `appcfg.py`.
1. Unzip `appengine/` to the `/wp-content/plugins/` directory
2. Deploy your code to App Engine
3. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= Why can't I use the plugin installer/upgrader? =
For security reasons, all code on App Engine must be deployed via `appcfg.py`.
This includes WordPress plugins and themes, as well as editing files via the
administration panel.
= Is this plugin required to run WordPress on App Engine? =
We recommend running App Engine for WordPress to ensure that all WordPress
functionality works correctly. Without this plugin, you will not be able to send
email or upload files, and some UI may be broken.
== Caching ==
We recommend using the [Batcache][] and [Memcache][] drop-ins to cache your
WordPress site. Batcache integrates with Memcache to cache your site on the App
Engine memcache server and will ensure that CloudSQL is used as little as
possible, reducing your costs.
If you host a rarely updated site, we suggest adding the following configuration
to your `wp-config.php`:
$batcache = [
'seconds' => 0,
'max_age' => 60 * 30, // 30 minutes.
];
This will cache pages on your site for a year and ensure that they do not expire
in memcache. With this setup and a fully primed cache, all anonymous users will
be served via Memcache with no hits to CloudSQL.
Note that using WordPress' built-in comments will enable commenters to bypass
the cache, so if you want to use comments on a fully-cached site, we recommend
[Intense Debate][] or [Disqus][] (with the synchronization disabled).
[Batcache]: http://wordpress.org/plugins/batcache/
[Memcache]: http://wordpress.org/plugins/memcache/
[Intense Debate]: http://wordpress.org/plugins/intensedebate/
[Disqus]: http://wordpress.org/plugins/disqus-comment-system/
== Changelog ==
= 1.5 =
* Fix for media uploads failing in WordPress 4.0 due to incorrect auth cookies
being copied.
= 1.4 =
* Use a default 30 second timeout for URLFetch requests.
* Use auto loading for GAE SDK now that it is available.
* Use CloudStorageTools::getPublicUrl() for Cloud Storage URLs so that they
work correctly on the development server.
* Add support for serving uploaded media files over HTTPs.
= 1.3 =
* Add support for importing a WDX file from Google Cloud Storage into the site.
* Provide a URL Fetch based HTTP client, which is optimized for the App Engine
environment. This also corrects issues caused by fsockopen only being available
to paid application in the production environment.
* Fix bug detecting if the Cloud Storage bucket is writable during plugin setup.
= 1.2 =
* Use CloudStorageTools::getPublicUrl in the dev environment so PIL is not a requirement.
* Fix Readme file to highlight that the plugin is for Google App Engine only.
* Work around is_writable check in the development environment.
= 1.1 =
* Fix uploads issue on the development server where PyCrypto is not available.
* include 'max_bytes_per_blob' in createUploadUrl options only if wp_max_upload_size() is a positive int
* Remove writable bucket check work around is this is now natively supported.
= 1.0 =
* Initial release
== Upgrade Notice ==
= 1.4 =
* Use a default 30 second timeout for URLFetch requests.
* Use auto loading for GAE SDK.
* Use CloudStorageTools::getPublicUrl() for Cloud Storage URLs so that they
work correctly on the development server.
* Add support for serving uploaded media files over HTTPs.
= 1.3 =
* Add support for importing a WDX file from Google Cloud Storage into the site.
* Provide a URL Fetch based HTTP client, which is optimized for the App Engine
environment. This also corrects issues caused by fsockopen only being available
to paid application in the production environment.
= 1.2 =
* Use CloudStorageTools::getPublicUrl in the dev environment so PIL is not a requirement.
* Work around is_writable check in the development environment.
= 1.1 =
* Fix uploads issue on the development server where PyCrypto is not available.
* include 'max_bytes_per_blob' in createUploadUrl options only if wp_max_upload_size() is a positive int
* Remove writable bucket check work around is this is now natively supported.
= 1.0 =
This version is the initial release of Google App Engine for WordPress.