# LiteCart LiteCart is a lightweight e-commerce platform for online merchants. Developed in PHP, HTML 5, and CSS 3. LiteCart is a registered trademark, property of founder T. Almroth - [LiteCart AB](https://www.litecart.net/). ## Tech Stack - **Application**: PHP, HTML5, CSS3, JavaScript - **Server**: Apache2, Nginx, Caddy, IIS or compatible web server - **Database**: MySQL or MariaDB - **Build Tools**: Node.js (via package.json), Grunt (gruntfile.js) ## How To Install For an updated version of the upgrade documentation, visit [How To Install](https://www.litecart.net/wiki/how_to_install). What you need: - An Apache2 web server running PHP 5.6 or higher. Latest stable PHP release recommended for best performance. - A MySQL 5.7+ or MariaDB database. ### Instructions Please note: Running your own website requires some common sense and basic webmastering skills. If this is not your area of expertise, ask a colleague or friend to assist you. 1. Connect to your web host via FTP using your favourite FTP software. 2. Transfer the contents of the folder public_html/ in this archive (yes the contents inside the folder - not the folder itself). Transfer it to your website root directory. Using subdirectories is supported but not recommended. ```text Examples: - /var/www/ - /home/username/public_html/ - C:\xampp\htdocs\ ``` Paths are machine specific, so talk to your web host if you are uncertain where this folder is. 3. Point your web browser to the URL of your website followed by the subfolder `install/` e.g. `http://www.mysite.com/install/`. If you placed LiteCart in a subfolder of the web root, the path should be something like `http://www.mysite.com/litecart/install`. The installation page should now load. 4. Carefully read the instructions on the page. Fill in your details for database, region, etc. Click the Install button when you are ready. If everything went well LiteCart should be successfully installed. For community written installation instructions see [How To Install](https://www.litecart.net/en/wiki/how_to_install). ## Documentation See our wiki for guides, examples and documentation: [https://www.litecart.net/wiki/](https://www.litecart.net/wiki/) ## How To Get Started To get your store up and running, see our [step list](https://www.litecart.net/en/wiki/get_started) for best practice. ## Folder Structure ```text / – Root ├── admin/ – Backend │ ├── *.app/ – Admin apps │ └── *.widget/ – Dashboard widgets ├── cache/ – Cache Directory ├── data/ – Data Storage ├── ext/ – Extensions/Extras/External/Vendors/Assets │ ├── jquery/ │ └── ... ├── images/ – Graphics ├── includes/ │ ├── abstracts/ – Class templates │ ├── boxes/ – Partials │ ├── entities/ – Entity objects │ ├── functions/ – Helper functions, called via lib_func.inc.php using functions::name() │ ├── library/ – System nodes and events │ ├── modules/ – Modules │ ├── references/ – Read-only factory model reference objects │ ├── routes/ – Route mapping │ ├── templates/ – HTML and Output │ └── wrappers/ – Wrappers, Service Layers, and Clients ├── install/ – Installation wizard ├── logs/ – Application logs ├── pages/ – Documents └── vmods/ – Virtual Modifications (vMod™ by LiteCart) ``` ## Data Collections and Entities This is an alphabetical list of different types of data objects or entities that you will come across when using the platform: [Attributes](https://www.litecart.net/wiki/attributes), [Categories](https://www.litecart.net/wiki/categories), [Countries](https://www.litecart.net/wiki/countries), [Currencies](https://www.litecart.net/wiki/currencies), [Customers](https://www.litecart.net/wiki/customers), [Delivery Statuses](https://www.litecart.net/wiki/delivery_statuses), [Emails](https://www.litecart.net/wiki/emails), [Geo Zones](https://www.litecart.net/wiki/geo_zones), [Languages](https://www.litecart.net/wiki/languages), [Manufacturers](https://www.litecart.net/wiki/manufacturers), [Modules](https://www.litecart.net/wiki/modules), [Orders](https://www.litecart.net/wiki/orders), [Order Statuses](https://www.litecart.net/wiki/order_statuses), [Pages](https://www.litecart.net/wiki/pages), [Products](https://www.litecart.net/wiki/products), [Quantity Units](https://www.litecart.net/wiki/quantity_units), [Slides](https://www.litecart.net/wiki/slides), [Sold Out Statuses](https://www.litecart.net/wiki/sold_out_statuses), [Suppliers](https://www.litecart.net/wiki/suppliers), [Tax Classes](https://www.litecart.net/wiki/tax_classes), [Tax Rates](https://www.litecart.net/wiki/tax_rates), [Translations](https://www.litecart.net/wiki/translations), [Users/Administrators](https://www.litecart.net/wiki/administrators). ## Framework Components An alphabetical list of framework components that you can find in LiteCart. [Backend](https://www.litecart.net/wiki/backend), [Backend Apps](https://www.litecart.net/wiki/apps), [Backend Widgets](https://www.litecart.net/wiki/widgets), [Breadcrumbs](https://www.litecart.net/wiki/breadcrumbs), [Cache](https://www.litecart.net/wiki/cache), [Cart](https://www.litecart.net/wiki/cart), [CSV](https://www.litecart.net/wiki/csv), [Database](https://www.litecart.net/wiki/database), [Document](https://www.litecart.net/wiki/document), [Entities](https://www.litecart.net/wiki/entities), [Events](https://www.litecart.net/wiki/events), [HTTP Client](https://www.litecart.net/wiki/http_client), [Functions/Helpers](https://www.litecart.net/wiki/functions), [Frontend](https://www.litecart.net/wiki/frontend), [Length](https://www.litecart.net/wiki/length), [Nodes](https://www.litecart.net/wiki/nodes), [Notices](https://www.litecart.net/wiki/notices), [Pages/Controllers](https://www.litecart.net/wiki/controllers), [Partials](https://www.litecart.net/wiki/partials), [Reference Model](https://www.litecart.net/wiki/references), [Routing System](https://www.litecart.net/wiki/routes), [Session](https://www.litecart.net/wiki/sessions), [Settings](https://www.litecart.net/wiki/settings), [SMTP Client](https://www.litecart.net/wiki/smtp_client), [Stylesheets](https://www.litecart.net/wiki/stylesheets), [Stats](https://www.litecart.net/wiki/stats), [Templates](https://www.litecart.net/wiki/templates), [Template Layouts](https://www.litecart.net/wiki/layouts), [Template Views](https://www.litecart.net/wiki/views), [vMod](https://www.litecart.net/wiki/vmod), [Weight](https://www.litecart.net/wiki/weight), [Volume](https://www.litecart.net/wiki/volume). ## How To Change The Look Of Your Store Navigate to the folder ~/includes/templates/default.catalog/ and you will find all HTML content and CSS files to edit. If you want to adapt your work with LESS instead of CSS you will need a LESS compiler. We recommend downloading our [Developer Kit](https://www.litecart.net/addons/163/developer-kit) that has a preconfigured LESS compiler and JavaScript minifier. See our wiki article [How To Create a Template](https://www.litecart.net/en/wiki/how_to_create_a_template). ## Contributing See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on contributing to the project. ## License This project is licensed under the terms specified in [LICENSE.md](LICENSE.md). ## See Also - [Official Website](https://www.litecart.net) - [GitHub Repository](https://github.com/litecart/litecart) - [Issue Tracker](https://github.com/litecart/litecart/issues) - [Community Forums](https://www.litecart.net/forums/) - [Community Wiki](https://wiki.litecart.net/)