Updating pMachine
Very Important:
If you are using a version of pMachine older than 2.2, please contact support@pmachine.com before proceeding. You will need to perform some additional steps.
Be sure to make a backup of both your site files as well as a backup of your database before proceeding. This should be standard practice and you should remember to do this at regular intervals.
Jump to a Section
Please carefully select the instructions based on the version of pMachine you are currenty using:
- Currently using pMachine Free 2.2 or 2.2.1
- Currently using pMachine Pro 2.2 or 2.2.1
- Migrating from pMachine Free 2.3 to pMachine Pro 2.3
- Updating forums to match pMachine.com
Updating to Version 2.3
Step 1
Delete the file called install.php, located in the pm directory. You do not need it.
Step 2
Save your config file
Download your existing config file (config.php) from your server and copy your existing settings to the new config file located inside the pm directory of the 2.3 distribution.
Step 3
On your server, delete everything contained inside your control panel (pm) directory (cp, db, lib, docs, language, etc.) except your images folder.
Note: Be sure not to delete your public site files. These are the files of your actual site such as weblog.php, comments.php, archives.php, etc.
Essentially, you will not touch any files in this step outside of your pm directory.
Step 4
Upload all of the files and directories contained in the 2.3 pm folder to your server, including your new config file.
Step 5
Replace the file called members.php, located in your members directory with the new one from the 2.3 distribution.
Step 6
Upload the following files into the same directory containing your web pages (such as weblog.php, comments.php, etc.):
- pingserver.php
- pingbacks.php
- trackbacks.php
Step 7
Find the image called v2.3.jpg, located in the pm/images directory of this distribution. Upload it to the pm/images directory on your server.
Step 8
Pro Users: Upload the directory called mailinglists into the same directory that contains your website pages.
Step 9
Everyone: Run the update script
Point your browser to the pm/updates/index.php file on your server. This file will update you to version 2.3 Be sure that you're accessing the file through your webserver and not just loading the file into your web browser locally. Access the file as you would a regular webpage, using an address similar to http://www.yourdomain.com/pm/updates/index.php.
Delete the updates directory from your server when you are finished with the update.
Step 10 (Optional)
Incorporating Trackback and Pingback into your site
In order to use the new Trackback and Pingback features you must add links to both pages in your weblog template. Go to: Control Panel > Edit Templates > Weblog Templates > Weblog Multi-Entry Templates
In the second template down from the top, add the code below, wherever you want the links to your Trackback and/or Pingback to appear:
Trackback link:
[%%trackback_total%%]
<a href="" onclick="window.open('%%trackback_url%%', '_blank',
'width=480,height=480,scrollbars=yes,status=yes')">Trackbacks</a>
Pingback link:
[%%pingback_total%%]
<a href="" onclick="window.open('%%pingback_url%%', '_blank',
'width=480,height=480,scrollbars=yes,status=yes')">Pingbacks</a>
You may wish to similarly add these to your single-entry page in Control Panel > Edit Templates > Weblog Templates > Weblog Single-Entry Templates
For information on how to use the Trackback and Pingback features, please consult those sections of the manual.
Migrating From pMachine Free 2.3 to pMachine Pro 2.3
Step 1
Replace these directories in your control panel (pm) directory:
- cp
- db
- lib
- updates
Step 2
Replace these files in your control panel (pm) directory:
- index.php
- inc.cp.php
- inc.lib.php
Step 3
Upload the directory called mailinglists into the same directory that contains your website pages.
Step 4
Replace the file called members.php, located in your members directory with the new one from this distribution.
Step 5
Upload the file called events.php, located in the calendar directory into the same location that currently has your calendar index.php page; usually in the directory calendar.
Step 6
Run the update script
Point your browser to the pm/updates/index.php file on your server. This will update you to pMachine Pro. Be sure that you're accessing the file through your webserver and not just loading the file into your web browser locally. Access the file as you would a regular webpage, using an address similar to http://www.yourdomain.com/pm/updates/index.php.
Delete the updates directory from your server when you are finished with the update.
Updating forums to match pMachine.com
These are optional instructions that enable you to change the look of your existing forum to match the forums at pMachine.com.
Step 1
Create a new forum template.
Find the file called forum_update.php, located in the forum directory. Move this file into your pm directory and load it with your browser. You must move the file for the update to work. It will create a new set of templates, formatted to look like the ones at pMachine.com. Be sure that you're accessing the file through your webserver and not just loading the file into your web browser locally. Access the file as you would a regular webpage, using an address similar to http://www.yourdomain.com/pm/forum_update.php.
Note: Your old forum templates will not be deleted. You may do so once you are finished with the update.
Step 2
Set up your new forum index.php page
Open the file called index.php located in the forum directory of the 2.3 distribution and set is up similarly to your existing forum index page, by duplicating the table for each forum you have and putting the name of each forum in the various tags in that file.
Step 3
Add your forum names to the bread-crumb navigation
Open the file called forum_names.php, located in the forum directory. You'll find instructions contained in that file for adding your forums to the breadcrumb.
Step 4
Replace your forum files
Delete all the files in your existing forum directory and replace them with the new ones.
Step 5
Switch to your new templates
In your Control panel, go to the weblog preference page (under Weblog Management) for each of your forums and switch the template set pull-down menu to correspond to your new template.
Step 6 (Optional)
Delete old template
Once you are satisfied that your forum looks the way it should you can delete your old forum templates. Click Edit Templates in your control panel and delete your old template set.