-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
131 lines (87 loc) · 3.66 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
=== Nginx Mobile Theme ===
Contributors: miyauchi,megumitheme,amimotoamis
Tags: nginx, mobile, theme, smartphone, tablet, iphone, ipad, android
Requires at least: 3.7.1
Tested up to: 4.9.8
Stable tag: 1.8.1
This plugin allows you to switch theme according to the User Agent on the Nginx reverse proxy.
== Description ==
This plugin allows you to switch theme according to the User Agent on the Nginx reverse proxy.
Nginx Mobile Theme's requirements are as follows.
* PHP 5.3 or later
* WordPress 3.7 or later
* [Nginx Cache Controller](http://wordpress.org/plugins/nginx-champuru/) 2.0.0 or later
= Some Features =
* You can flush mobile's and pc's each caches automatically via [Nginx Cache Controller](http://wordpress.org/plugins/nginx-champuru/).
* Allow you to switch theme according to the user-agent.
* Allow you to customize multiple mobile device support via filter-hook.
= Nginx Configuration =
Add mobile device detection to the nginx.conf.
`set $mobile '';
if ($http_user_agent ~* '(iPhone|iPod|incognito|webmate|Android|dream|CUPCAKE|froyo|BlackBerry|webOS|s8000|bada|IEMobile|Googlebot\-Mobile|AdsBot\-Google)') {
set $mobile "@smartphone";
}`
Set proxy_cache_key.
`proxy_cache_key "$mobile$scheme://$host$request_uri";`
Send custom request header to the backend.
`proxy_set_header X-UA-Detect $mobile;`
Nginx Mobile Theme will switch theme when '@smartphone' is received in the `$_SERVER['HTTP_X_UA_DETECT']`.
= How to use =
1. Please access to the theme-customizer in the WordPress admin area.
2. Please select Mobile Theme in the drop-down.
3. Click "Save & Publish" button to save.
= Multiple mobile device support =
1. Add custom mobile detection to the nginx.conf.
2. Add custom mobile detection to the WordPress via `nginxmobile_mobile_detects` filter-hook.
nginx.conf:
`set $mobile '';
if ($http_user_agent ~* '(iPhone|iPod)') {
set $mobile "@smartphone";
}
if ($http_user_agent ~* 'iPad') {
set $mobile "@tablet";
}`
In your custom plugin:
`add_filter('nginxmobile_mobile_detects', function(){
return array('@smartphone', '@tablet');
});`
* As a result, allow you to select theme for @smartphone and @tablet individually in the theme-customizer.
= Amimoto Support =
The [Amimoto](http://megumi-cloud.com/) is a full-tuned WordPress AMI on the AWS EC2.
* Uncomment /etc/nginx/conf.d/default.conf in line 17
before:
`#include /etc/nginx/mobile-detect;`
after:
`include /etc/nginx/mobile-detect;`
* Add line to /etc/nginx/nginx.conf like following.
before:
`proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Accept-Encoding "";`
after:
`proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Accept-Encoding "";
proxy_set_header X-UA-Detect $mobile; # add new line`
* Define constant in the wp-config.php
`define('IS_AMIMOTO', true);`
== Installation ==
1. Upload `nginx-mobile-theme` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
== Screenshots ==
1. theme-customizer
== Changelog ==
= 1.8.1 =
* Add query strings mobile=on and mobile=off
= 1.5.0 =
* [Bug fix.](https://github.com/megumiteam/nginx-mobile-theme/compare/1.4.0...1.5.0)
= 1.4.0 =
* [Bug fix.](https://github.com/megumiteam/nginx-mobile-theme/compare/1.3.0...1.4.0)
= 1.3.0 =
* [Bug fix.](https://github.com/megumiteam/nginx-mobile-theme/compare/1.2.0...1.3.0)
= 1.2.0 =
* [Add mobile theme preview.](https://github.com/megumiteam/nginx-mobile-theme/compare/1.1.0...1.2.0)
= 1.1.0 =
* Add support child theme.
* Add notice when Nginx Cache Controller is not activated.
https://github.com/megumiteam/nginx-mobile-theme/compare/1.0.0...1.1.0
= 1.0.0 =
* first release.