1
0
mirror of https://github.com/processwire/processwire.git synced 2025-08-08 07:47:00 +02:00

Additional README updates

This commit is contained in:
Ryan Cramer
2016-09-23 11:52:25 -04:00
parent 6f279d5f23
commit 50f2834a0a

View File

@@ -3,6 +3,7 @@
This document is in Markdown. An HTML formatted version of this document
can be read at: https://github.com/processwire/processwire/blob/master/README.md
## Table of Contents
1. [About](#about-processwire)
@@ -11,6 +12,7 @@ can be read at: https://github.com/processwire/processwire/blob/master/README.md
4. [Troubleshooting](https://processwire.com/docs/install/troubleshooting/)
5. [Support](#support-and-links)
## About ProcessWire
ProcessWire is an open source content management system (CMS) and web
@@ -51,29 +53,24 @@ Chances are that you can upgrade simply by replacing the /wire/ directory.
### Upgrading from ProcessWire 2.x
If upgrading from ProcessWire 2.5 or older, we recommend that you upgrade
to ProcessWire 2.7 or 2.8 first. Both of those versions include details in the
README file on how to upgrade from these older versions of ProcessWire.
* ProcessWire 2.8: <https://github.com/processwire/processwire-legacy>
* ProcessWire 2.7: <https://github.com/ryancramerdesign/processwire>
To upgrade from ProcessWire 2.6 (or newer) to ProcessWire 3.x, please follow the
instructions below.
to ProcessWire [2.8](https://github.com/processwire/processwire-legacy) or
[2.7](https://github.com/ryancramerdesign/processwire) first. Both of those
versions include details in the README file on how to upgrade from these
older versions of ProcessWire. To upgrade from ProcessWire 2.6 (or newer)
to ProcessWire 3.x, please follow the instructions below.
1. Login to the admin of your site.
2. Edit your /site/config.php and set `$config->debug = true;` to ensure you can
see error messages.
2. Edit your `/site/config.php` file and set `$config->debug = true;` to ensure
you can see error messages. This is optional but recommended.
3. Replace your /wire/ directory and /index.php file with the ones from here.
Don't forget the /index.php as it is definitely required (it will tell you
if you forget).
3. Replace your `/wire/` directory and `/index.php` file with the new ones from here.
4. Click a tab page in your admin, such as "Pages". You may notice a delay.
4. Click a navigation link in your admin, such as "Pages". You may notice a delay.
This is ProcessWire compiling 3rd party modules into a format that is
compatible with version 3.x. Keep an eye out for any error messages.
If you see any issues, it's possible you may need to upgrade one or more
3rd party modules. If you see messages about it apply updates, keep hitting
3rd party modules. If you see messages about it applying updates, keep hitting
reload in your browser until you no longer see any update messages.
5. Once you've resolved error messages in your admin, you'll want to test out
@@ -88,22 +85,26 @@ instructions below.
`$config->debug` setting back to `false` in your /site/config.php file.
**Troubleshooting a 3.x upgrade**
If you run into any trouble upgrading, please see our Troubleshooting an Upgrade
guide located at <https://processwire.com/download/troubleshooting/#upgrades>
If you run into any trouble upgrading, please see our troubleshooting guide
located at <https://processwire.com/download/troubleshooting/#upgrades>.
### Pro module upgrade notes
- If using FormBuilder, we recommend using only v0.3.0 or newer.
- If using ProCache, we recommend using only v3.1.4 or newer.
- If using ListerPro, we recommend using only v1.0.9 or newer.
- If using [FormBuilder](https://processwire.com/api/modules/form-builder/),
we recommend using only v0.3.0 or newer.
- If using [ProCache](https://processwire.com/api/modules/procache/),
we recommend using only v3.1.4 or newer.
- If using [ListerPro](https://processwire.com/api/modules/lister-pro/),
we recommend using only v1.0.9 or newer.
- If using [ProFields](https://processwire.com/api/modules/profields/),
we recommend grabbing the latest versions in the ProFields support board.
- If using ProCache and you upgraded your .htaccess file, you should
go to your ProCache settings after the upgrade to have it update
your .htaccess file again. If no upgrades to your .htaccess file
are necessary, then the ProCache settings page won't mention it.
## Debug Mode
Debug mode causes all errors to be reported to the screen, which can be
@@ -131,10 +132,11 @@ resolved any issues.
## Support and Links
* [ProcessWire Support](https://processwire.com/talk/)
* [ProcessWire Weekly](https://weekly.pw/)
* [ProcessWire Blog](https://processwire.com/blog/)
* [Follow @processwire on Twitter](http://twitter.com/processwire/)
* [Contact ProcessWire](https://processwire.com/contact/)
* [Sites running ProcessWire](https://processwire.com/about/sites/)
* [Read the ProcessWire Blog](https://processwire.com/blog/)
------