-
-
Notifications
You must be signed in to change notification settings - Fork 68
/
readme.txt
249 lines (192 loc) · 8.13 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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
=== WP Multi Network ===
Author: Triple J Software, Inc.
Author URI: https://jjj.software
Donate link: https://buy.stripe.com/7sI3cd2tK1Cy2lydQR
Plugin URI: https://wordpress.org/plugins/wp-multi-network/
License URI: https://www.gnu.org/licenses/gpl-2.0.html
License: GPLv2 or later
Contributors: johnjamesjacoby, flixos90, rmccue, spacedmonkey
Tags: network, sites, domains, global, admin
Requires PHP: 5.2
Requires at least: 4.9
Tested up to: 6.1
Stable tag: 2.5.2
== Description ==
Turn your WordPress Multisite installation into many multisite networks, surrounding one global set of users.
* Reveals hidden WordPress Multisite functionality.
* Includes a "Networks" top-level Network-Admin menu.
* Includes a List Table for viewing available networks.
* Allows moving subsites between networks.
* Allows global administrators to create new networks with their own sites and domain arrangements.
* Group sites into logical networks using nearly any combination of domain (example.org) and path (/site/).
== Installation ==
* Download and install using the built in WordPress plugin installer.
* Activate in the "Plugins" network admin panel using the "Network Activate" link.
* Comment out the `DOMAIN_CURRENT_SITE` line in your `wp-config.php` file. If you don't have this line, you probably need to <a href="https://codex.wordpress.org/Create_A_Network">enable multisite</a>.
* Start planning and creating your networks.
== Frequently Asked Questions ==
= Can each network have a different domain? =
Yes you can. That is what this plugin does best!
Think of how WordPress.org works:
* wordpress.org
* make.wordpress.org/core
* buddypress.org
* codex.buddypress.org
* bbpress.org
* codex.bbpress.org
* wordcamp.org
* us.wordcamp.org/2021
Users are global, and they can login to any of those domains with the same login and password. Each of those domains has their own subdomains and subdirectories, many of which are sites or (networks of them).
= Will this work on standard WordPress? =
You can activate it, but it won't do anything. You need to have the multisite functionality enabled and working first.
= Where can I get support? =
Create a GitHub issue: https://github.com/stuttter/wp-multi-network/issues/new
= What about multisite constants? =
For maximum flexibility, use something like...
`
// Multisite
define( 'MULTISITE', true );
define( 'SUBDOMAIN_INSTALL', false );
define( 'PATH_CURRENT_SITE', '/' );
define( 'DOMAIN_CURRENT_SITE', $_SERVER['HTTP_HOST'] );
// Likely not needed anymore (your config may vary)
//define( 'SITE_ID_CURRENT_SITE', 1 );
//define( 'BLOG_ID_CURRENT_SITE', 1 );
// Un-comment and change to a URL to funnel no-site-found requests to
//define( 'NOBLOGREDIRECT', '/404/' );
/**
* These are purposely set for maximum compatibility with multisite and
* multi-network. Your config may vary.
*/
define( 'WP_HOME', 'https://' . $_SERVER['HTTP_HOST'] );
define( 'WP_SITEURL', 'https://' . $_SERVER['HTTP_HOST'] );
`
= What about cookies? =
Use something like this to allow cookies to work across networks...
`
// Cookies
define( 'COOKIEHASH', md5( 'yourrootdomain.com' ) );
define( 'COOKIE_DOMAIN', 'yourrootdomain.com' );
define( 'ADMIN_COOKIE_PATH', '/' );
define( 'COOKIEPATH', '/' );
define( 'SITECOOKIEPATH', '/' );
define( 'TEST_COOKIE', 'thing_test_cookie' );
define( 'AUTH_COOKIE', 'thing_' . COOKIEHASH );
define( 'USER_COOKIE', 'thing_user_' . COOKIEHASH );
define( 'PASS_COOKIE', 'thing_pass_' . COOKIEHASH );
define( 'SECURE_AUTH_COOKIE', 'thing_sec_' . COOKIEHASH );
define( 'LOGGED_IN_COOKIE', 'thing_logged_in' . COOKIEHASH );
`
= Uploads? =
As of version 3.5, new WordPress multisite installs use a more efficient way to serve uploaded files.
Unfortunately, this doesn't play well with multiple networks (yet). Installs that upgraded from 3.4 or below are not affected.
WP Multi-Network needs to be running to help set the upload path for new sites, so all networks created with this plugin will have it network activated.
If you disable it on one of your networks, any new site you create on that network will store its uploaded files under that network's main site's uploads folder. It's not pretty.
Just leave this plugin network-activated (or in mu-plugins) and it will take care of everything.
= Can I achieve a multi-level URL path structure (domain/network/site) with a subfolder network? =
To achieve nested folder paths in this fashion network1/site1, network1/site2 etc,
please follow the steps in https://paulund.co.uk/wordpress-multisite-nested-paths to construct a custom sunrise.php (Thanks to https://paulund.co.uk for providing these steps).
= Where can I find documentation? =
Not much to talk about really. Check the code for details!
== Changelog ==
= 2.5.2 =
* Use get_main_site_id function instead of get_main_site_for_network.
* Tested against WordPress 6.1.
= 2.5.1 =
* Save main site on network as network option.
= 2.5.0 =
* Fix new networks sometimes not being created.
* Fix moving sites sometimes not working.
* Fix network name always being "New Network".
* Fix several debug notices related to filter_input().
* Fix several redirection & admin-notice issues.
* Allow networks to be created with empty network name & site name.
* Update author link & plugin meta data.
= 2.4.2 =
* Update code for WordPress coding standards.
* Other small bug fixes.
= 2.4.1 =
* Update required PHP / wordpress versions.
= 2.4.0 =
* Add networks REST API endpoint.
= 2.3.0 =
* Add network capability mapping.
* Add WP CLI command.
* Other improvements.
= 2.2.1 =
* Fix upload paths still using blogs.dir.
= 2.2.0 =
* WordPress 4.9 minimum version bump.
* Fix bug preventing sites from being moved.
* Tweak some styling.
* Use more WordPress core functions for sites & networks.
= 2.1.0 =
* Add nonce checks to forms.
* Add validation & output sanitization to form fields.
= 2.0.0 =
* WordPress 4.6 minimum version bump.
* Caching improvements for WordPress 4.6.
* Refactor list tables & admin method code.
= 1.8.1 =
* Fix site reassignment metabox from moving sites incorrectly.
= 1.8.0 =
* Support for core compat functions.
* Fix bug causing site moves to break.
* Fix bug allowing duplicate site URLs.
* Remove _network_option() functions.
* Remove network.zero placeholder.
* WordPress 4.5 & 4.6 compatibility updates.
= 1.7.0 =
* WordPress 4.4 compatibility updates.
* Metabox overhaul.
* network.zero improvements.
* Fix site assignments.
* Various UI improvements.
* Global, class, function, and method cleanup.
= 1.6.1 =
* WordPress 4.3 UI compatibility updates.
* Remove site "Actions" column integration.
= 1.6.0 =
* Move inclusion to muplugins_loaded.
* Introduce network switching API.
* Introduce network options API.
* Update action links to better match sites list.
* Better support for domain mapping.
* Refactor file names & locations.
* Deprecate wpmn_fix_subsite_upload_path().
* Include basic WPCLI support.
* Escaped gettext output.
* Fix bulk network deletion.
* Scrutinized code formatting.
= 1.5.1 =
* Fix debug notices when creating networks.
* Fix incorrect variable usage causing weird output.
* Adds default path when creating new networks.
= 1.5 =
* Support for WordPress 3.8.
* Finally, a menu icon!
* Improved output sanitization.
= 1.4.1 =
* Fix issue when changing network domain or path - contributed by mgburns.
* Improve support for native uploaded file handling.
= 1.4 =
* Fix admin pages (let us know if you find something broken).
* Add support for WP 3.5+ upload handling - thanks, RavanH (see notes: "What's up with uploads?").
= 1.3.1 =
* Fix prepare() usages.
* Fix some debug notices.
= 1.3 =
* Refactor into smaller pieces.
* Add PHP docs.
* Deprecate functions for friendlier core-style functions.
* Code clean-up.
* Remove inline JavaScript.
= 1.2 =
* Implemented 3.1 Network Admin Menu, backwards compatibility maintained.
* Fix multiple minor issues.
* Add Site Admin and Network Admin to Network lists.
* Add various security and bullet proofing.
= 1.1 =
* Better WordPress 3.0 compatibility.
= 1.0 =
Getting started.