Difference between revisions of "How to Install"

From Phoenix Cart User Guide
 
(138 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
NEW INSTALLATION OF PHOENIX
+
<div class="btn btn-grey btn-back">{{#fas:arrow-left}} Back</div> <div class="btn btn-grey btn-download">{{#fas:download}} Download & Install</div>
 +
<hr>
 +
__TOC__
 +
Open web browsing software and enter the web address of your website in the address bar - e.g <code>yoursite.com</code> to start the installation process.
  
−
This how we have installed Phoenix on our host server with success
+
==='''Welcome'''===
 +
*<big>'''The first CE Phoenix Cart installation ''Welcome'' page will open - you will see this:'''</big>
 +
<div class="mainpage_box">
 +
[[File:install1.jpg|link=|]]
 +
</div>
 +
*Ensure the server and database meet requirements, see - <big>'''https://github.com/CE-PhoenixCart/PhoenixCart#requirements'''</big>
 +
*Ensure all '''Server Capabilities''' are checked with a green thumbs up to proceed. If not, contact your server host.
 +
*Click <span class="btn-green">Start the installation procedure</span>
  
−
Some actions will depend on host server - host servers may slightly differ
 
  
−
You will need (freely available):
+
----
  
−
FTP (file transfer) software to connect to your host server and transfer files between your computer and the host server e.g. Filezilla
+
==='''Step 1'''===
 +
*<big>'''The next CE Phoenix Cart ''Step 1'' installation page will open:'''</big>
 +
<div class="mainpage_box">
 +
[[File:install2.jpg|link=|]]
 +
</div>
  
−
File editing software to edit .php files e.g. Sublime Text or Visual Studio Code
+
*Complete the form.
 +
*For '''Database Server''' enter the default of '''localhost''' which is most commonly used by hosts otherwise your host will provide the correct value if the default is incorrect. To specify a port number other than the default 3306, use a colon, e.g. '''localhost:3308''' will use localhost as the hostname and 3308 as the port number. For advanced configuration, e.g. for persistent connection, see '''https://www.php.net/manual/en/mysqli.construct.php'''
 +
*Enter the '''Database Username''', '''Password''' and '''Database Name''' that were created when the database was created.
 +
*Choose '''Import Sample Data''' to install sample products which can be removed later. This is useful for first time users to see how the store displays and works.
 +
*Click <span class="btn-green">Continue To Step 2</span>
  
−
BEFORE INSTALLATION
 
  
−
1. Create a folder/directory for all "website documents" - name it, save it and save a back up
+
----
  
−
2. Create a "text document" file to save username/passwords etc. and log website actions - save it in the "website documents" folder/directory
+
==='''Step 2'''===
 +
*<big>'''The next CE Phoenix Cart ''Step 2'' installation page will open:'''</big>
 +
<div class="mainpage_box">
 +
[[File:install3.jpg|link=|]]
 +
</div>
  
−
3. Create domain name, host account, SSL certificate - save host name, username and password to "text document"
+
*It will automatically show your website address ('''WWW Address''') - check the address and change the '''http''' to '''https''' if you have already created a SSL certificate.
 +
*It will also show the path to your website on the server ('''Webserver Root Directory''') - make a record of this.
 +
*Click <span class="btn-green">Continue To Step 3</span>
  
−
4. Create a database in host server account - save database name, username and password to "text document"
 
  
−
5. Download file transfer (FTP) software - e.g. Filezilla
+
----
  
−
6. Download file editing software - e.g. Sublime Text or Visual Studio Code
+
==='''Step 3'''===
 +
*<big>'''The next CE Phoenix Cart ''Step 3'' installation page will open:'''</big>
 +
<div class="mainpage_box">
 +
[[File:install4.jpg|link=|]]
 +
</div>
  
−
7. Download web browsing software - e.g. Chrome
+
*Enter your '''Store Name''' - customers will see this but can be changed at any time.
 +
*Enter your '''Store Owner Name''' - customers will see this but can be changed at any time.
 +
*Enter your '''Store Owner E-Mail Address''' - this will be used in e-mails but can be changed at any time.
 +
*Create '''Administrator Username''' and '''Administrator Password''' - these will used to securely log in to the Admin Dashboard (Backend) of the website not accessible to the public - save these.
 +
*Enter a secure/random name for '''Administration Directory Name''' - make a record of this.
 +
*Select a Time Zone
 +
*Click <span class="btn-green">Continue To Step 4</span>
  
−
8. Download Phoenix (zipped folder/directory) ensure you have the latest version
 
  
−
9. Copy Phoenix zipped folder/directory to "website documents"
+
----
  
−
10. Unzip Phoenix zipped folder/directory to "website documents"
+
==='''Step 4'''===
 +
*<big>'''The final CE Phoenix ''Step 4'' installation page will open:'''</big>
  
−
11. Open and read "README" file carefully
+
<div class="mainpage_box">
 +
[[File:install5.jpg|link=|]]
 +
</div>
 +
*Three buttons will show on this page.
 +
**'''Admin (Backend)''' takes you to the '''Admin Dashboard''' of your website, this is not visible or accessible to the public, you will need your administrator username and password to access.
 +
**'''Store (Frontend)''' takes you to the '''Catalog''' index page also known as the '''Store''' or '''Shop''', this is visible and accessible to the public.
 +
**'''Phoenix Forum''' takes you to the '''CE PHOENIX CART FORUM'''. There you will find the '''COMMUNITY SUPPORT FORUM''' open to all for help and advice. Register there and get involved.
  
−
INSTALLATION
 
  
−
NOTE: Ensure domain name, host account and SSL certificate have been created - check with host server providers before proceeding
+
----
  
−
NOTE: This procedure installs Phoenix in the root folder/directory so the website home page will show as yoursite.com/index.php in the web browser
+
==='''Finish'''===
 +
*Click the '''Admin (Backend)''' button to go to the Admin Dashboard to secure the website in the next step.
 +
*You will see this to log in.
  
−
NOTE: Some users may wish to install in a sub-folder/directory so the website home page will show as
+
<div class="mainpage_box">
−
yoursite.com/subdirectory/index.php in the web browser - if this is required a sub-folder/directory must be created, named and opened before step 14. below
+
<center>[[File:adminlogin.png|link=]]</center>
 +
</div>
  
−
12. Open Filezilla - connect to host server using host name, username, password - appears in right window pane "Remote site:"
+
See <big>'''[[Admin Dashboard]]'''</big> for the complete user guide to Admin Dashboard.
  
−
13. In "Remote site" open root folder/directory "htdocs" - dependent on server may be named "public_html" or "httpdocs"
 
  
−
14. In left window pane "Local site:" navigate to and open unzipped Phoenix folder/directory
+
<hr>
−
 
+
<span class="btn-grey">[[How_to_Upload|&#129032; Previous Step]]</span>
−
15. Lasso (hold down left mouse click and drag cursor) to select all folders and files in unzipped Phoenix folder/directory
+
<span class="btn-grey">[[How to Secure|Next Step &#129034;]]</span>
−
 
+
<hr>
−
16. Drag and drop all files into "htdocs" in "Remote site:" to transfer all files to host server
+
{{Forum}}
−
 
+
{{Pro}}
−
17. Filezilla will indicate progress at the bottom of screen - it can take several minutes to complete transfer
+
{{Contribute}}
−
 
 
−
Relax with a cup of tea and slow, deep breathing
 
−
 
 
−
18. Open web browsing software - enter the web address of your website in the address bar - e.g https://www.yoursite.com
 
−
 
 
−
19. The first Phoenix installation "Welcome" page will open - click "Start the installation procedure"
 
−
 
 
−
20. The second Phoenix installation page will open - complete the form
 
−
 
 
−
21. For Database Server enter localhost - enter database username, password and database name - choose Import sample data so sample products will show in your shop - they can easily be removed later - click continue
 
−
 
 
−
22. The third Phoenix installation page will open - this will automatically show your website address and root - save them to "text document" - click continue
 
−
 
 
−
23. The fourth Phoenix installation page will open - enter the email address customers will see - create Administrator Username and Password - enter a secure/random name for Administration Directory Name - select a Time Zone
 
−
 
 
−
24. Save Administrator Username and Password to "text document" - click continue
 
−
 
 
−
25. The final Phoenix installation "Finished" page will open
 
−
 
 
−
Two buttons will show on this page - one takes you to the Administration index page where you will need your Administrator Username and Password, this is the "Back Office" or "back end" of your website not visible or accessible to the public - the other button takes you to the Catalog index page, this is the "Shop" or "front end" of your website visible and accessible to the public
 
−
<br><historylink type="back" />
 

Latest revision as of 13:56, 8 July 2026

Back
Download & Install

Open web browsing software and enter the web address of your website in the address bar - e.g yoursite.com to start the installation process.

Welcome

  • The first CE Phoenix Cart installation Welcome page will open - you will see this:

Install1.jpg


Step 1

  • The next CE Phoenix Cart Step 1 installation page will open:

Install2.jpg

  • Complete the form.
  • For Database Server enter the default of localhost which is most commonly used by hosts otherwise your host will provide the correct value if the default is incorrect. To specify a port number other than the default 3306, use a colon, e.g. localhost:3308 will use localhost as the hostname and 3308 as the port number. For advanced configuration, e.g. for persistent connection, see https://www.php.net/manual/en/mysqli.construct.php
  • Enter the Database Username, Password and Database Name that were created when the database was created.
  • Choose Import Sample Data to install sample products which can be removed later. This is useful for first time users to see how the store displays and works.
  • Click Continue To Step 2


Step 2

  • The next CE Phoenix Cart Step 2 installation page will open:

Install3.jpg

  • It will automatically show your website address (WWW Address) - check the address and change the http to https if you have already created a SSL certificate.
  • It will also show the path to your website on the server (Webserver Root Directory) - make a record of this.
  • Click Continue To Step 3


Step 3

  • The next CE Phoenix Cart Step 3 installation page will open:

Install4.jpg

  • Enter your Store Name - customers will see this but can be changed at any time.
  • Enter your Store Owner Name - customers will see this but can be changed at any time.
  • Enter your Store Owner E-Mail Address - this will be used in e-mails but can be changed at any time.
  • Create Administrator Username and Administrator Password - these will used to securely log in to the Admin Dashboard (Backend) of the website not accessible to the public - save these.
  • Enter a secure/random name for Administration Directory Name - make a record of this.
  • Select a Time Zone
  • Click Continue To Step 4


Step 4

  • The final CE Phoenix Step 4 installation page will open:

Install5.jpg

  • Three buttons will show on this page.
    • Admin (Backend) takes you to the Admin Dashboard of your website, this is not visible or accessible to the public, you will need your administrator username and password to access.
    • Store (Frontend) takes you to the Catalog index page also known as the Store or Shop, this is visible and accessible to the public.
    • Phoenix Forum takes you to the CE PHOENIX CART FORUM. There you will find the COMMUNITY SUPPORT FORUM open to all for help and advice. Register there and get involved.


Finish

  • Click the Admin (Backend) button to go to the Admin Dashboard to secure the website in the next step.
  • You will see this to log in.
Adminlogin.png

See Admin Dashboard for the complete user guide to Admin Dashboard.


🠈 Previous Step Next Step 🠊

Many Addons and Extensions available in the CE Phoenix Cart Addons Library

If help is needed, support is available in the CE Phoenix Cart Support Forum

Phoenix Cart User Guide, like CE Phoenix Cart, is free to use but is maintained by unpaid volunteers.

Code references are licensed under a Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales License.
All other content is the reserved Intellectual Property and Copyright of phoenixcart.org
Retrieved from ‘https://phoenixcart.org/phoenixcartwiki/index.php?title=How_to_Install&oldid=5631’