I am adding my own installation guide. I wrote this while installing XAMPP and Modx on my Mac (so certain things will need to be translated to windows etc).
Download XAMP to view php files locally.
http://www.apachefriends.org/en/xampp-macosx.html
Install
Startup and start Apache and MySQL
http;//localhost/xampp/
On the left further down is a link to
http://localhost/phpmyadmin/
Create a database which can be used by Modx.
Unzip modx and place it into XAMPP -> htdocs folder
In your web browser go to
http://localhost/modx/setup/
If you get a FATAL ERROR message:Modx Setup cannot continue. It is probably because the folder is write protected. Inside mod -> core -> is a folder cache that needs to be writable. Right click and choose Get Info (properties). On the bottom it will say if it is write protected or not. Click staff and everyone and choose Read & Write.
Go back and refresh http://localhost/modx/setup/
The Modx installation screen should show up.
Press Next -> New Installation -> Next
Connection information
(I am using Xampp and creating the login name and skipping the password from what Xampp recommends.)
Most of the fields were filled in already. The only field I filled in was login name and Database name.
Host: localhost
login name: root (Xampp mentions it)
password: just skip the password as in no password (Xampp mentions that there is no password)
Database name: I called mine mod
Table prefix: mine is modx_
Click:
Test database server connection and view collations.
Result
Connecting to mysql server: Success!
Click:
Create or test selection of your database.
Result
Checking database: Success!
One will need to fill out the values below. These are the values I used.
Default Admin User
The below username, email and password you can choose as you like.
username: admin (what I chose)
email:
[email protected] (my real e-mail address)
password: 12345 (what I chose)
password: 12345 (what I chose)
The Summary page:
My core/export directory is writable: Failed
core/packages directory is writable: Failed
core/config/config.inc.php exists and is writable: Failed
I made the export and the packages directory writable similar to what I did earlier.
Made a new text document, saved it with the rtf ending. Clicked the name and pasted in config.inc.php. Which made the document into a php file. Placed it into the config folder. But text pad placed some text into it so I had to go into dreamweaver and create a php file there. Be sure to check the code that there is no text, if there is just delete it. Or use Notepad or similar text program.
I also had to make the file writable. Right click -> get info and make staff and everyone writeable. Retry the page it should now say ok where it earlier said failed.
Press Install
Next page it says Installation Summary
Press Next
---
Important note:
modx/assets - was not created
modx/assets/components - was not created
modx/core/components - was not created
This is for 3rd party components.
I might as well create these folders. Which I did. These also need to be made writable!
Press Login button
Below is a check box for deleting the setup directory. If I was going to install this on a web site I would likely have the setup folder either renamed or deleted. Since others can access the setup folder and screw up my installation. But I am doing this on my own computer to learn so I am just leaving the setup directory as it is.
Login
Username: admin (admin is the most used username, it is up to you what you want to call it)
Password: whatever you want it to be
admin and 123456 is what I used.
I also pressed the check box Remember me, so that I do not need to fill in username and password every time I plan to check out my modx install folder.
I am in! This is the frontend screen.
Modx is now installed. The next step as I see it is to create some html files and import them into Modx.
I need more practice on design before I go ahead and share it here. I’ll write down as I go.
Hopefully this install guide along with other peoples guides will help with the install. Next up for this community is to create easy to follow bare bones design guides. Bob Ray’s and EinsteinBoi’s Guides will also be of help.