Apps take a considerable amount of time to build, support and maintain. Please, if you find this useful, thank me in the forum or consider a donation.
Please backup your files and database before installing this and any add-on. Great care has been taken to produce quality code, but I accept no responsibility for any damages, either business or private, as a result of using this code. This code is provided "as is" and you are solely responsible for support and maintenance of the code and your shop.
catalog (new files)
folder can be uploaded in its entirety. They are all new files there that will not conflict with your current
shop files. Please take care to maintain the folder structure intact.catalog (modified osCommerce files)
contains two modified existing shop files.As usual, the "catalog" part of each file path refers to the root of the shop, not an actual folder.
?>
Surfalot CMS automatically installs the database component when it is accessed for the first time. You can do this by going to the new Administrative group in the Admin called Surfalot CMS. Click on List All. Alternatively, you can open your shop's home page.
Surfalot CMS Admin Configuration Options Once installed, you may wish to review the configuration options in the Configuration section of the Admin under Surfalot CMS. You should see a direct link to the Configuration in the upper right corner of the List All page called Configure.
Install Header Tags Modules One Header Tags module that is required to help Surfalot CMS function completely. Please Go to Admin > Modules > Header Tags > Install Module button To install the SEO - Pages Module. The rest of these Header Tags modules are not required by Surfalot CMS, but are quite useful: Category SEO, Manufacturer SEO, Product SEO
SurfCMS Information Box Module The SurfCMS App Pages module is a Box module included with Surfalot CMS that you can fill with pages and links. If you wish to use it, install it in the Shop's Admin Modules Administrator here: Modules > Boxes > Install Module > SurfCMS App Pages
SurfCMS Navigation Bar Content Module The Navigation Bar is a Content Module you can use to display your shop's main navigation menu. To the Surfalot CMS Navbar you can add current pages, create new pages, other links, and osCommerce Community Edition Edge Navbar modules. For the convenience of Community Edition GOLD shop owners, I have included the navigation bar modules with Surfalot CMS. GOLD shop owners can use these within Surfalot CMS. Install the SurfCMS Navigation Bar in the Shop's Admin Modules Administrator here: Modules > Content > Install Module > SurfCMS Navigation Bar.
You should to disable or remove the standard Community Edition Navigation Bar at this time, if it is already installed.
The standard Community Edition Navbar modules do not need to be installed through the Shop's Admin Modules Administrator themselves on Edge Shops, generally. GOLD Shops do not have the Navbar Module installer, but the modules are included with Surfalot CMS and SHOULD work fine.
If you find one that doesn't behave correctly or needs its settings, install the Navbar module in Modules > Navbar Modules > Install Module, then set Enable to False. That will ensure the module does not display twice and will display correctly in the SurfCMS Navigation Bar.
You may use Surfalot CMS to manage the entire Navbar menu if you wish. Surfalot CMS was designed to allow the user flexibility to use both the standard osCommerce Navbar Module Installer and Surfalot CMS at the same time. If you wish to use Surfalot CMS to manage the entire Navbar menu, you should remove modules from the standard Navbar Module Installer now. In Modules > Navbar Modules, click on a module and then click the Remove Module button on the right. Leave the Hamburger Button installed and enabled here. It is required to display a menu on smaller devices.
You may use wish to install the Sample Menu for a head start. Go to the Surfalot CMS Admin menu and select Utilities/Guide. Then on the right, click the Insert a Sample Menu button, and confirm install. This menu is similar to the Navbar that is included with osCommerce Community Edition GOLD.
A new Navbar module is included with Surfalot CMS. It is called the Brand Image module. It is just like the Brand module, except that is uses the Shop's logo in place of the Shop's name. You can update the logo image to any image you have uploaded. It will insert the logo defined in the Admin > Configuration > Shop Logo by default.
If you desire a local installation of TinyMCE instead of a CDN retrieval, this is how. Surfalot CMS is setup to look for a local installation first. All you need to do is download the TinyMCE Community version and install it on your server. At the date of this publication, the download place is: https://www.tinymce.com/download/
Within the download package you will find several folders. Find the tinymce folder that contains
the file tinymce.min.js. Copy that tinymce folder to the shop folder catalog/ext/
.
The full path to the tinymce.min.js file should be: catalog/ext/tinymce/tinymce.min.js
.
** As usual, "catalog" refers to the root of your shop, not the first subfolder.
Please Note: This is optional and not necessarily preferred for production shops. Mainly for those developing on local platforms. Do your own research and make your own judgement on CDN vs Local installation.
Local Bootstrap Install for osCommerce v2.3.4 Official Only Those of you with the osCommerce Community Editions can skip this. It is already locally installed on your shop.
If you desire a local installation of Bootstrap CSS, Bootstrap Javascript, and Font Awesome instead of a CDN retrieval, this is how. Surfalot CMS is setup to look for a local installation first. All you need to do is download the files and install it on your server. At the date of this publication, the download place is: https://getbootstrap.com/docs/3.3/
Create a new folder called bootstrap in your shop's catalog/ext/
folder.
Within the download package you will find several folders.
Find the css folder that contains the file bootstrap.min.css.
Copy the css folder from the bootstrap download
to your new shop folder: catalog/ext/bootstrap.
The full path to the bootstrap.min.css file should be: catalog/ext/bootstrap/css/bootstrap.min.css
Find the js folder that contains bootstrap.min.js.
Copy the js folder from the bootstrap download
to your new shop folder: catalog/ext/bootstrap.
The full path to the bootstrap.min.js file should be: catalog/ext/bootstrap/js/bootstrap.min.js
** As usual, "catalog" refers to the root of your shop, not the first subfolder.
Font Awesome Install for osCommerce v2.3.4 All Versions Now we'll download and install Font Awesome. At the date of this publication, the download place is: http://fontawesome.io/
Create a folder called font-awesome in your shop's catalog/ext/
folder.
Within the download package you will find several folders.
Find the css folder that contains
the file font-awesome.min.css. Copy the css folder from the download package
to your new shop folder: catalog/ext/font-awesome.
The full path to the font-awesome.min.css file should be: catalog/ext/font-awesome/css/font-awesome.min.css
.
Find the fonts folder that contains
the file fontawesome-webfont.woff2. Copy the fonts folder from the download package
to your new shop folder: catalog/ext/font-awesome.
The full path to the fontawesome-webfont.woff2 file should be: catalog/ext/font-awesome/fonts/fontawesome-webfont.woff2
.
** As usual, "catalog" refers to the root of your shop, not the first subfolder.
For osCommerce v2.3.4 Official shop folks:
When installed, the Header Tags module: Font Awesome Head Link
included with Surfalot CMS will add the Font Awesome link tag in your shop's header.
For osCommerce v2.3.4 Community Edition shop folks:
In order to utilize the local installation of Font Awesome, you must make a change to your template_top.php file.
Find in catalog/includes/template_top.php
Replace with
Finished! Upload catalog/includes/template_top.php