A plain-English walkthrough. About ten minutes, and you do not need to be technical.
Use this guide with any AI assistant
Download it as a prompt file, paste it into Claude, ChatGPT, Gemini or any LLM, and it will walk you through every step interactively.
public_html, or public_html/yourdomain.com if you have more than one site..zip, and wait for it to finish.
pagemotor.php, a lib folder, and a file called config-sample.php sitting in your site folder. (If extracting gave you a single folder called pagemotor instead, open it, select everything inside, choose Move and move it all into your site folder, then delete the empty folder and the zip.) Good. We use that sample file in step 3.PageMotor keeps your content in a database. Make one in three quick stages.
pagemotor and click Create Database.
theaccount_ prefix in front of the name field.)pagemotor is saved as something like theaccount_pagemotor, and the user the same way. Copy the full names exactly as cPanel shows them. You will need three things in the next step: the database name, the username, and the password.This is the file that connects PageMotor to the database you just made.
config-sample.php next to pagemotor.php.config.php. This rename is the step that switches PageMotor on.config.php and choose Edit.DB_NAME, DB_USER and DB_PASSWORD, using the full prefixed names from step 2. Leave the rest as they are, then Save.Here is what the database section of your config.php should look like once filled in. Edit the existing lines to match; you are changing three values, not pasting this block in:
// Database connection info:
define('DB_NAME', 'theaccount_pagemotor'); // exact name from cPanel
define('DB_USER', 'theaccount_pmuser'); // exact username from cPanel
define('DB_PASSWORD', 'your-strong-password');
define('DB_HOST', 'localhost'); // correct for Bluehost and most cPanel hosts
define('DB_CHARSET', '');
define('DB_COLLATE', '');
define('DB_TABLE_PREFIX', 'pm_');
define('DB_FLAGS', '');
define('PM_HTML_CHARSET', '');
config.php (not config-sample.php, and not config.php.txt), and it must sit in the same folder as pagemotor.php.yoursite.com/admin/ and create your admin user.Open these only if you hit them. Each one is quick.
most commonAlmost always a config.php problem. Check three things:
config.php (not still config-sample.php, and not config.php.txt).pagemotor.php.error_log file in your site folder. If it says config.php "No such file or directory", this is your fix.Good news, that means config.php is now working and PageMotor reached the database step. It just could not log in. Re-check, against the exact names cPanel shows:
theaccount_ part).DB_HOST is not localhost. If the three values above are definitely right, check your host's database details page or welcome email, or ask their support, for the correct host name.The PHP version is rarely the cause. A missing or misnamed config.php fails the same way on every version, so changing it makes no difference. Sort the config.php first. PageMotor is happy on modern PHP 8.x.
It ships inside the PageMotor download, right next to pagemotor.php. Two things to check: the files may have landed in a pagemotor subfolder when the zip extracted, in which case move everything in it up into your site folder (see the note in step 1); and if the folder is genuinely empty, the zip did not extract completely, so repeat step 1.