Breeze Website Builder™ Installation and Setup Instructions

Server Requirements

  • PHP 5 or later (tested thru version 7.4) (must not be running in safe mode)
    • MySQL Native Driver (mysqlnd) (unless you are going to use another database other than MySQL or MariaDB) and PHP Data Objects (pdo) must be installed
    • GD (gd) and Exchangeable image information (exif) is required for image optimization
    • Zip (zip) is required for plugin installation
    • Calendar (calendar) is required for calendars and events
    • cURL (curl) is used by some plugins
    • allow_url_fopen must be on to for update checking and backups
    • BCMath Support (bcmath) and multi-byte string handling (mbstring) maybe required for shopping cart plugins
  • MySQL 5 or later (tested thru version 5.7.28) or MariaDB 10 or later (tested thru version 10.3.29) (unless you are going to use another database)
  • FTP access
  • phpMyAdmin (recommended for munual installation)
  • (chmod access might be required on some servers)
  • Note: It could work fine with other SQL-type databases (MS-SQL, PostgreSQL, SQLite), but you will need to install the appropriate database driver extension for whatever database you choose to use. These other databases very well may not work 100%. Please contact us if you find it does not work with another database and you need to use that database.

 

Files

Unzip all of the files to a folder on your hard drive. Note: The download file is a .tar.gz file. We recommend you use 7-zip to extract the files. You can download 7-zip here. When you extract the file it will first create a .tar file. You will then need to extract the files from the .tar file.

 

CMS Database

Create a MySQL database named "cms" using the MySQL command interface, or the MySQL section of your CPanel.  Note: On servers using CPanel, the actual name of the database will include your CPanel user name, i.e. {cpanelusername}_cms.  Create a user-named "website" and assign a strong password. Note: On servers using CPanel, the actual name of the database user will include your CPanel user name, i.e. {cpanelusername}_website. Assign the new user to the new database with full permissions.

Note: GoDaddy does not use a prefix for the database name and the user name is the same as the database name.  You will also need to change your server from localhost to something like mybwbdb.db.7571864.hostedresource.com where mybwbdb is the name of your GoDaddy-hosted database.

 

Program Files

FTP all files to the web root folder on your site (usually public_html, www or htdocs).  Note: The permissions of the files should be set to 0644, and the folders should be set to 0755.

 

Installation Wizard

Go to http://example.com/install/install.php, enter the database authentication information that you created above, set any options you would like to change, enter an admin password and click the submit button.  Your config files will be generated automatically and the database with be populated withe the necessary tables.  After the installation is complete, click on the button to enter the Breeze Website Builder.  Ether admin for the username and the password you created on the previous screen.  After logging in, you will see a warning about the installation files being present on the server.  Click the link to delete the installation files.  At this point the installation is complete.

 

Manual Installation  (if Installation Wizard will not work for you)

If something should go wrong with the installation wizard, you can optionally setup the system manually.  Here are the details:

Populating the Database

Run the SQL commands database in SQL/database.sql to populate the "cms".  You can use the MySQL command interface, or phpMyAdmin.

 

Database Connection File

Open connect/db_connect.php with a text editor. Modify the values for $database, $db_username, and $password to match what you created above.

 

Config File

You may want to change the folders and table prefix defaults for your installation.  These parameters are set in connect/config.php.  By default, your web pages will be stored in userfiles/file.  This is done so you can install the Breeze Website Builder in the same hosting as an existing site, and then deploy the new site under Breeze when you are ready to go without affecting the current site.  But you may want to set your webpage folder to be the webroot folder if there is no pre-existing website to be concerned with.  This eliminates the display of folders under your domain in the browser address bar.  i.e. http://example.com/userfiles/file becomes simply http://example.com.  To do this, set BWB_BASE_DIR and BWB_WEBPAGE_DIR to '' <blank>.  All other folder defaults must have some non-empty name for the system to work properly.

Special note about changing folders from defaults: Paths to images, CSS or scripts might not translate 100% correctly for templates if you change from the default locations.  This can be corrected by editing locations throughout your pages and your CSS, but it could be quite tedious and not necessarily obvious to non-web developers.

By default, all table names will have the prefix bwb_.  If you want to run more than one Breeze Website Builder off of the same database you may change the prefix for the second installation: i.e. bwb2_.  You can use a case-sensitive global search and replace on the database.sql file to change your prefix before running the SQL to install the tables.  Note: a case-insensitive search and replace with also change the references to the defined global constants in the page templates which will break them.

 

Using the Breeze Website Builder™ – Logging in the First Time

The login to the manager area is at http://example.com/manage/ where example.com is your website domain name.  The default logins are as follows:

User ID            Password
  admin              admin123
  user                 user123
  power_user     power_user123

Login as admin the first time and click on Manage Users and Site Options.  Then click on Manage Users and change the passwords for all three of the built-in accounts.  You may instead delete the user and power_user users if you wish.  Click on the help icon within the Breeze Website Builder™ and go to the Getting Started section to find out more about using the system.

 

Selecting Default Page Layout:

From the main menu, click on Manage Users and Site Options, then click on Change Site Options.  Select the site layout that you want to use, e.g. top_bottom_left_right.

 

Special Note for GoDaddy Hosting

The KFM file manager does not load properly out of the box with GoDaddy hosting.  You will need to modify line 216 in kfm/index.php from:

<script type="text/javascript" src="j/all.php/can-minify"></script>

to:

<script type="text/javascript" src="j/all.php"></script>