Skip to content
100644 251 lines (233 sloc) 17.6 KB
10685d9 @mvied Version 2.0.3
1 === WordPress HTTPS (SSL) ===
2 Contributors: Mvied
3 Donate link:
4 Tags: security, encryption, ssl, shared ssl, private ssl, public ssl, private ssl, http, https
1b224d3 @mvied Fixed typos in readme.
5 Requires at least: 3.0
94ed783 @mvied Updated tested version to 3.4.
6 Tested up to: 3.4
41eee7a @mvied Updated to version 3.2.
7 Stable tag: 3.2
10e588b @mvied Readme.txt update.
8 License: GPLv3
10685d9 @mvied Version 2.0.3
10 WordPress HTTPS is intended to be an all-in-one solution to using SSL on WordPress sites.
12 == Description ==
bc4e029 @mvied Updated support link in readme.txt.
13 If you're having partially encrypted/mixed content errors or other problems, please read the <a href="">FAQ</a>. If you're still having trouble, please <a href="">start a support topic</a> and I will do my best to assist you.
10685d9 @mvied Version 2.0.3
15 == Installation ==
16 1. Upload the `wordpress-https` folder to the `/wp-content/plugins/` directory.
17 1. Activate the plugin through the 'Plugins' menu in WordPress.
19 == Frequently Asked Questions ==
20 = How do I fix partially encrypted/mixed content errors? =
21 To identify what is causing your page(s) to be insecure, please follow the instructions below.
22 <ol>
23 <li>Download <a href="" target="_blank">Google Chrome</a>.</li>
24 <li>Open the page you're having trouble with in Google Chrome.</li>
25 <li>Open the Developer Tools. <a href="" target="_blank">How to access the Developer Tools.</a></li>
26 <li>Click on the Console tab.</li>
27 </ol>
28 For each item that is making your page partially encrypted, you should see an entry in the console similar to "The page at displayed insecure content from" Note that the URL that is loading insecure content is HTTP and not HTTPS.
10e588b @mvied Readme.txt update.
30 Once you have identified the insecure elements, you need to figure out what theme or plugin is causing these elements to be loaded. Although WordPress HTTPS does its best to fix all insecure content, there are a few cases that are impossible to fix. Here are some typical examples.
10685d9 @mvied Version 2.0.3
31 <ul>
10e588b @mvied Readme.txt update.
32 <li>The element is external (not hosted on your server) and is not available over HTTPS. These elements will have to be removed from the page by disabling or modifying the theme or plugin that is adding the element.</li>
33 <li>The element is internal (hosted on your server) but does not get changed to HTTPS. This is often due to a background image in CSS or an image or file path in JavaScript being hard-coded to HTTP inside of a CSS file. The plugin can not fix these. The image paths must be changed to relative links. For example `` to simply `/wp-content/themes/mytheme/images/background.jpg`. Ensure you copy the entire path, including the prepended slash (very important).</li>
10685d9 @mvied Version 2.0.3
34 </ul>
10e588b @mvied Readme.txt update.
36 = I can't get into my admin panel. How do I fix it? =
37 Go to /wp-content/plugins/wordpress-https/wordpress-https.php and uncomment (remove the two forward slashes before) the line below, or go to your wp-config.php file and add this line. Hit any page on your site, and then remove it or comment it out again.
38 `define('WPHTTPS_RESET', true);`
40 = How do I make my whole website secure? =
41 To make your entire website secure, you simply need to change your site url to use HTTPS instead of HTTP. Please read <a href="" target="_blank">how to change the site url</a>.
926521b @mvied Updated to readme.txt.
42 Alternatively, you can use URL Filters in the WordPress HTTPS Settings to secure your entire site by putting just '/' as a filter. This will cause any URL with a forward slash to be secure (all of them).
10e588b @mvied Readme.txt update.
44 = How do I make only certain pages secure? =
45 The plugin adds a meta box to the add/edit post screen entitled HTTPS. In that meta box, a checkbox for 'Secure Post' has been added to make this process easy. See Screenshots if you're having a hard time finding it.
926521b @mvied Updated to readme.txt.
46 Alternatively, you can use URL Filters to secure post and pages by their permalink.
10e588b @mvied Readme.txt update.
5d11d52 @mvied Re-organized modules.
48 = I'm using Force SSL Administration and all of the links to the front-end of my site are HTTPS. Why? =
49 For many users this behavior is desirable. If you would like links the the front-end of your site to be HTTP, enable Force SSL Exclusively and do not secure your front-end pages.
10e588b @mvied Readme.txt update.
51 = I'm getting 404 errors on all of my pages. Why? =
52 If you're using a public/shared SSL, try disabling your custom permalink structure. Some public/shared SSL's have issues with WordPress' permalinks because of the way they are configured. If you continue to recieve 404 errors, there may be no way to use WordPress with that particular public/shared SSL.
5d11d52 @mvied Re-organized modules.
54 = I'm receiving a blank page with no error. What gives? =
55 This is most commonly due to PHP's memory limit being too low. Check your Apache error logs just to be sure. Talk to your hosting provider about increading PHP's memory limit.
10685d9 @mvied Version 2.0.3
57 = Is there a hook or filter to force pages to be secure? =
a488612 @mvied Moved core re-usable classes into their own library.
58 Yes! Here is an example of how to use the 'force_ssl' filter to force a page to be secure.
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
59 `function custom_force_ssl( $force_ssl, $post_id = 0, $url = '' ) {
10685d9 @mvied Version 2.0.3
60 if ( $post_id == 5 ) {
61 return true
62 }
63 return $force_ssl;
64 }
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
66 add_filter('force_ssl' , 'custom_force_ssl', 10, 3);`
10685d9 @mvied Version 2.0.3
777ab75 @mvied Updated to readme.txt.
68 You can also use this filter to filter pages based on their URL. Let's say you have an E-commerce site and all of your E-commerce URL's contain 'store'.
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
69 `function store_force_ssl( $force_ssl, $post_id = 0, $url = '' ) {
70 if ( strpos($url, 'store') !== false ) {
777ab75 @mvied Updated to readme.txt.
71 $force_ssl = true;
72 }
73 return $force_ssl;
74 }
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
76 add_filter('force_ssl', 'store_force_ssl', 10, 3);`
777ab75 @mvied Updated to readme.txt.
10685d9 @mvied Version 2.0.3
78 == Screenshots ==
79 1. WordPress HTTPS Settings screen
80 2. Force SSL checkbox added to add/edit posts screen
82 == Changelog ==
cedde53 @mvied Updated readme.txt.
83 = 3.2 =
84 * Added domain mapping. Domain mapping allows you to map external domains that host their HTTPS content on a different domain.
9e0aa04 @mvied Added Remove Unsecure Element option.
85 * Added Remove Unsecure Elements option. If possible, this option removes external elements from the page that can not be loaded over HTTPS, preventing insecure content errors without modifying any code.
32091b2 @mvied Update readme.txt.
86 * ClouldFlare support.
e3065a6 @mvied Updated readme.txt.
87 * Substantial memory optimization.
4bc9a12 @mvied Removed secure front page option. Added Force SSL Login.
88 * Removed Secure Front Page option. This can now be achieved through URL Filters.
220d591 @mvied Typo fixes in readme.txt.
89 * Bug Fix - Visiting the admin panel over HTTP when using Shared SSL should no longer log the user out, but will now redirect accordingly.
90 * Bug Fix - Random 404 errors should be gone.
3301186 @mvied Updated to version 3.1.3.
91 * Bug Fix - Fixed bug where a bad setting for ssl_host would cause the code to fail.
fa01797 @mvied Updated readme.txt.
92 * Bug Fix - CSS backgrounds that do not have quotes should no longer break debug output.
5d078f8 @mvied Fixed bug where URL parameters were being stripped on redirects. Upda…
93 = 3.1.2 =
b708e76 @mvied Updated readme.txt.
94 * Bug Fix - Redirects should no longer remove URL parameters.
5d078f8 @mvied Fixed bug where URL parameters were being stripped on redirects. Upda…
95 * Bug Fix - Removed loginout filter that was changing links to plain text.
b708e76 @mvied Updated readme.txt.
96 * Bug Fix - Plugin should no longer cause JavaScript errors from removing quotes from the end of URL's.
97 * Bug Fix - CSS backgrounds that do not have quotes should no longer break debug output.
52d4a47 @mvied Fixed bug in Parser.
98 = 3.1.1 =
99 * Bug Fix - Fixed bug in Parser.
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
100 = 3.1 =
101 * Memory optimization.
a2c88e5 @mvied Added secure URL filtering.
102 * Added secure URL filtering.
a012562 @mvied Version to 3.0.5b1.
103 * Users receiving 404 errors on every page when using Shared SSL should now be able to use those Shared SSL's that previously did not work.
db33f3e @mvied Updated to version 3.1. Added URL to the force_ssl filter. Moved most…
104 * Added support for qTranslate.
105 * Added support for securing custom post types.
df78812 @mvied Updated FAQ.
106 * Added $url to the force_ssl filter as the third arguement. See FAQ for example usage.
71a7604 @mvied Fixed bug where plugin would try to load hidden files as modules.
107 = 3.0.4 =
108 * Fixed multiple bugs for sites using SSL for the entire site.
109 * Bug Fix - plugin should no longer try to load hidden files as modules.
62ee1cc @mvied Version 3.0.3.
110 = 3.0.3 =
111 * Any element on an HTTP page that is set to HTTPS should be auto-corrected.
b23d809 @mvied Updated readme.txt.
112 * Added support for domain mapper plugin.
113 * Bug Fix - SSL Host should now always end in a trailing slash.
62ee1cc @mvied Version 3.0.3.
114 * Bug Fix - Fixed bug in cookie logic that prevented some users from logging in.
115 * Bug Fix - Fixed bug in redirects that would cause login issues and 404 errors.
b355046 @mvied Updated to 3.0.2.
116 = 3.0.2 =
8ce8a4d @mvied Updated changelog.
117 * Added setting to change where HTTPS settings appear in the admin panel.
1d8593f @mvied Updated changelog.
118 * Bug Fix - Plugin should no longer interefere with editing posts and using images from the Media Library.
f276cdf @mvied Updated readme.txt.
119 * Bug Fix - Fixed major bug that occurred when site was installed in the base directory.
67d056e @mvied Ensured that URL objected returns a string.
120 * Bug Fix - File uploader should no longer produce an HTTP Error.
4412fe5 @mvied Updated readme.txt.
121 * Bug Fix - Fixed performance issue that caused the login page to load for a long period of time.
b355046 @mvied Updated to 3.0.2.
122 * Bug Fix - Proxy check should no longer interfere with RSS Feeds, HTML Validators, etc.
123 * Bug Fix - Force SSL and SSL Front Page should no longer conflict.
02a1816 @mvied Updated to 3.0.2 release.
124 * Bug Fix - If Force SSL Exclusively is enabled and Secure Front Page is not (or the front page is not secured), links to the front page will be set to HTTP.
87028d2 @mvied Fixed bug with archive widgets.
125 = 3.0.1 =
40b795b @mvied Updated readme.txt for 3.0.1.
126 * Bug Fix - Fixed major issue when upgrading from previous version of WordPress HTTPS.
e9ead3f @mvied Added is_ssl method for backwards compatibility.
127 * Bug Fix - Added is_ssl method back to main plugin class to avoid errors with Gravity Forms.
1b224d3 @mvied Fixed typos in readme.
128 * Bug Fix - Archive widget links should now appear correctly.
87ef852 @mvied Updated to version 3.0
129 = 3.0 =
130 * The plugin has been completely re-written.
131 * Redirect loops should no longer be an issue.
132 * Bugs are likely to occur.
e30d8fd @mvied Updated with 2.0.4 change log.
133 = 2.0.4 =
134 * Bug Fix - Users using Shared SSL should no longer have broken URL's and redirects.
87ef852 @mvied Updated to version 3.0
135 * Bug Fix - Pages should correctly be identified as HTTPS if PHP returns an IP address for SERVER_ADDR in $_SERVER.
e30d8fd @mvied Updated with 2.0.4 change log.
136 * Bug Fix - Users using the default permalink structure should now have URL's being properly changed to/from HTTPS.
10685d9 @mvied Version 2.0.3
137 = 2.0.3 =
138 * Force SSL Admin will always be enabled when FORCE_SSL_ADMIN is true in wp-config.php.
139 * Bug Fix - Users using Shared SSL should no longer have issues with the SSL Host path duplicating in URL's.
140 * Bug Fix - The plugin should now function properly when using a subdomain as the SSL Host.
141 * Bug Fix - Page and post links will only be forced to HTTPS when using a different SSL Host that is not a subdomain of your Home URL.
142 * Bug Fix - WordPress HTTPS should no longer generate erroneous notices and warnings in apache error logs. (If I missed any, let me know)
143 = 2.0.2 =
144 * Bug Fix - SSL Host option was not being saved correctly upon subsequent saves. This was causing redirect loops for most users.
145 = 2.0.1 =
146 * Ensured that deprected options are removed from a WordPress installation when activating the plugin.
147 * Added a button to the WordPress HTTPS settings page to reset all plugin settings and cache.
148 * Bug Fix - URL's entered for SSL Host were not validing correctly.
149 * Bug Fix - External URL's were not always being identified as valid external elements.
150 * Bug Fix - Slight enhancement to SSL detection.
151 = 2.0 =
152 * Full support for using a custom SSL port has been added. A special thanks to <a href="">Chris "doingweb" Antes</a> for his feedback and testing of this feature.
153 * Forcing pages to/from HTTPS is now pluggable using the 'force_ssl' filter.
154 * When using Force Shared SSL Admin, links to the admin panel will always be rewritten with the Shared SSL Host.
155 * When using Shared SSL, all links to post and pages from within the admin panel will use the Shared SSL Host to retain administration functionality on those pages.
156 * Redirects to the admin panel now hook into wp_redirect rather than using the auth_redirect pluggable function.
157 * Canonical redirects will now still occur on sites usinga different SSL Host, but not on secure pages.
158 * Cookies are now set with hooks rather than pluggable functions.
159 * Plugin will now delete all options and custom metadata when uninstalled.
160 * Added a HTTP_X_FORWARDED_PROTO check to the is_ssl function.
161 * Internal HTTPS Elements option has been removed. Disabling this option was never a good idea, so it was removed and the plugin will always act as it did when this option was enabled.
162 * External HTTPS Elements option has been removed. The handling of external elements has improved in such a way that this option is no longer required.
163 * Disable Automatic HTTPS option has been removed. This option should have generally been enabled anyway.
164 * Bug Fix - After logging in, the logged_in cookie was not being set properly. This caused the admin bar to not show up in both HTTP and HTTPS.
165 * Bug Fix - When using Shared SSL, the login page would not honor the redirect_to variable after a successful login.
166 = 1.9.2 =
167 * Added External URL caching to the plugin so that external elements will only be checked for once, increasing the speed of sites not using the Bypass External Check option.
168 * Any forms whose action points to page that has the Forced SSL option on will be updated to HTTPS even on HTTP pages.
169 * Bug Fix - When using Shared SSL, permalink structure was being buggy.
170 * Bug Fix - Certain server configurations were causing the plugin to create redirect loops when using the Force SSL Exclusively option.
171 = 1.9.1 =
172 * Bug Fix - Cookies were not being set to the correct paths when logging in, causing logins to fail.
173 * Bug Fix - Links to the front page when using latest posts were not correctly being set to HTTP/HTTPS.
174 * Bug Fix - When using Shared SSL, the HTTPS version of the site_url was not being correctly replaced with the Shared SSL URL for internal elements.
175 * Bug Fix - When using Shared SSL, the admin login page was not always redirecting properly due to output buffering.
176 * Bug Fix - When using Shared SSL, the auth_redirect function was not redirecting to the Shared SSL URL.
177 * Bug Fix - If the home_url contained 'www' but the URL appeared without 'www', the URL would not be fixed.
178 * Standards - Updated redirect method to use https or http as a an argument rather than true or false to better comply with WordPress coding standards.
179 = 1.9 =
180 * Created Updates widget on settings screen to allow for dynamic updates from the plugin developers.
181 * Added support for PHP4.
182 * Converted all spaces to tabs in source.
183 * Force Shared SSL Admin option added to allow those using Shared SSL the ability to use their certificate for their admin dashboard.
184 * Bug fix - Force SSL checkbox will now appear on WordPress versions below 2.9.
185 * Bug fix - Password protected pages forced to SSL will now work properly.
186 * Bug fix - Plugin should no longer break feeds.
187 * Numerous other bug fixes that have since been forgotten due to the length of time this version has been in development.
188 = 1.8.5 =
189 * In version 1.8.5, when a page is forced to HTTPS, any links to that page will always be HTTPS, even when using the 'Disable Automatic HTTPS' option. Likewise, when the 'Force SSL Exclusively' option is enabled, all links to pages not forced to HTTPS will be changed to HTTP on HTTPS pages.
190 * Updated RegEx's for more complicated URL's.
191 * Bug fix - When in the admin panel, only link URL's are changed back to HTTP again.
192 * Added support for using Shared SSL together with the FORCE_SSL_ADMIN and FORCE_SSL_LOGIN options.
193 = 1.8.1 =
194 * Re-enabled the canonical redirect for WordPres sites not using Shared SSL.
195 = 1.8 =
196 * Fixed cross-browser CSS issue on plugin settings page.
197 * Corrected and updated plugin settings validation.
198 * Lengthened the fade out timer on messages from the plugin settings page from 2 to 5 seconds so that the more lengthy error messages could be read before the message faded.
199 * If viewing an admin page via SSL, and your Home URL is not set to HTTPS, links to the front-end of the website will be forced to HTTP. By default, WordPress changes these links to HTTPS.
200 * When using Shared SSL, any anchor that links to the regular HTTPS version of the domain will be changed to use the Shared SSL Host.
201 * Added embed and param tags to the list of tags that are fixed by WordPress HTTPS. This is to fix flash movies.
202 = 1.7.5 =
203 * Bug fix - When using 'Latest Posts' as the front page, the front page would redirect to HTTP when viewed over HTTPS even if the 'Force SSL Exclusively' option was disabled.
204 * Prevented the 'Disable Automatic HTTPS' option from parsing URL's in the admin panel.
205 * General code cleanup and such.
206 = 1.7 =
207 * Bug fix - External URL's were not being forced to HTTPS after the last update.
208 * Added the functionality to correct relative URL's when using Shared SSL.
209 * General code cleanup and such.
210 = 1.6.5 =
211 * Added support for Shared SSL.
212 = 1.6.3 =
213 * Changed the redirection check to use `template_redirect` hook rather than `get_header`.
214 = 1.6.2 =
215 * Tag links were not being set back to HTTP when the 'Disable Automatic HTTPS' option was enabled.
216 = 1.6.1 =
217 * Bug fix - front page redirection was causing issues when a static page was selected for the posts page.
218 = 1.6 =
219 * Added the ability to force the front page to HTTPS.
220 * Multiple enhancements to core functionality of plugin. Mostly just changing code to integrate more smoothely with WordPress.
221 * Enhancements have been made to the plugin's settings page.
222 = 1.5.2 =
223 * Fixed a bug that would prevent stylesheets from being fixed if the rel attribute came after the href attribute. Bug could have also caused errors with other tags.
224 = 1.5.1 =
225 * Added input elements with the type of 'image' to be filtered for insecure content.
226 = 1.5 =
227 * Added the ability to force SSL on certain pages.
228 * Also added the option to exclusively force SSL on certain pages. Pages not forced to HTTPS are forced to HTTP.
229 * Plugin now filters the `bloginfo` and `bloginfo_url` functions for HTTPS URL's when the 'Disable Automatic HTTPS' option is enabled in WordPress 3.0+.
230 = 1.0.1 =
231 * Bug fix.
232 = 1.0 =
233 * Major modifications to plugin structure, efficiency, and documentation.
234 * Added the option to disable WordPress 3.0+ from changing all of your page, category and post links to HTTPS.
235 = 0.5.1 =
236 * Bug fix.
237 = 0.5 =
238 * Due to increasing concerns about plugin performance, the option to bypass the HTTPS check on external elements has been added.
239 = 0.4 =
240 * Plugin functions converted to OOP class.
241 * The plugin will now attempt to set the allow_url_fopen option to true with `ini_set` function if possible.
242 = 0.3 =
243 * Added the option to change external elements to HTTPS if the external server allows the elements to be accessed via HTTPS.
244 = 0.2 =
245 * Changed the way in which HTTPS was detected to be more reliable.
246 = 0.1 =
247 * Initial Release.
249 == Upgrade Notice ==
41eee7a @mvied Updated to version 3.2.
250 = 3.2 =
10e588b @mvied Readme.txt update.
251 You may lose your SSL Host setting upon upgrading if it is not default (matching your Site URL).
Something went wrong with that request. Please try again.