Download the PHP package cmsrs/cmsrs3 without Composer

CMS, gallery, and shop based on Laravel and Vue.js

REQUIRED PACKAGES

– PHP command-line interface

and – for XML parsing (used in layouts and configs)

– for HTTP requests

– for MySQL database connection

– for multibyte string support (required by PHPUnit and some packages)

– for image processing (used in gallery, sliders, etc.)

Make sure all extensions match your installed PHP version (e.g., php8.4-mysql, php8.4-mbstring, etc.)

INSTALLATION (QUICK SETUP)

Run the following command to create the project:

MANUAL INSTALLATION (RECOMMENDED)

• Download the source code:

• Install dependencies:

• Prepare .env file, and change db connection:

change db connection in .env file, for example:

You can create a MySQL user and database using the script:

• Set up Laravel and JWT (generate the application key and JWT secrets):

• Create database tables and seed initial data:

  • admin (email/login: [email protected], pass: cmsrs123)
  • client (email/login: [email protected], pass: cmsrs456)

• (optionally) Set up permission:

• Start server

RUN TESTS

• Prepare .env.testing file, and change db connection:

Change db connection in .env.testing file, for example:

Attention! DB_DATABASE should be different than the one in the .env file.

You can create a MySQL database using the script

• (optionally) set permission

• run tests:

It is recommended to run tests on a clean instance (without images)

MANAGMENT

• Go to the website http://127.0.0.1:8000/admin/

  log in as:

  username: [email protected]

  password: cmsrs123

• Create main page (page type: main_page)

• Add menu

• Add pages

CONFIGURATION .env FILE

After each change to a configuration value, it is necessary to log in to the admin panel again.

• Set up langs, the default is 'en,pl':

The first one will be default language. If you don't set up this directive it will be 'en,pl'

• Add api secret, the default is '':

It must be the same like in the admin config file (see Vue.js). It can be empty string.

• Set available page type that appear in the administration area:

The default page types are:

- cms: Displays a WYSIWYG editor in the administration area.
- gallery: A page for showcasing photos.
- shop: A page for displaying products.
- contact: A page with contact information.
- main_page: The main page, which requires writing pure HTML code.
- privacy_policy: A page containing the privacy policy.
- projects: Displays the same content across all languages.
- clear: A page without a WYSIWYG editor; requires writing pure HTML code.
- inner: Represents a text box on an existing page that requires hardcoding in the layout. The key is the short_title. For example, in the code:
    (new PageService)->getPageDataByShortTitleCache('main_page_box1', 'content');
    The following short_title values are predefined:
        - main_page_box1, main_page_box2, main_page_box3: Represent three content boxes on the main page.
        - company_data: Displays company information on the contact page.
        - main_page_slider: Contains images displayed in the slider on the main page, It requires adding a <div class='slidecontainer'></div> element to the main page.

• Additionally sending an e-mail with information from the contact form. If the value is empty, the text of the message will appear only in the administration panel in the contact tab

• For Google reCAPTCHA v3 in the contact form, set up the following parameters:

• Enable database cache, the default is false:

• Set the currency, the default is USD:

• Set is_shop, the default is true:

• Set is_login, the default is true:

• Set is_register, the default is true:

• Set the allowed file extensions for uploads:

The default file extensions for uploads are:

• PayU integration:

• Administrator Credentials

These credentials can be used to create the initial admin user during system installation (database seeding).

: The default email address of the admin account. : The default password for the admin account.

Warning: Do not use the default credentials ([email protected] / cmsrs123) in production. Always update them for security reasons before deploying.

• Client Account Credentials

These credentials can be used to create a default client account during system installation (e.g., for seeding or demo purposes).

: The default email address for the client account. : The default password for the client account.

Warning: Do not use the default client credentials ([email protected] / cmsrs456) in production environments. Always change them to secure values before deployment.

• DEMO Mode

Use this variable to enable demo mode, for example at http://demo.cmsrs.pl/ Used to block saving changes or modifying sensitive data on public demo instances.

Default is false (disabled).

• Pagination

Number of items per page in the admin panel. The default value is 10.

SAMPLE .env CONFIGURATION FOR COMPANY PROFILE PAGE

If you want to create a company profile page, I suggest setting the following CMS parameters, for example:

CLI COMMANDS

• Load test (demo) data:

I highly recommend running this script to understand how my CMS works. (Remember to leave the default values in the .env file.)

• Create sitemap (it is recommended to put this command in the crontab file):

• Create client user or edit password for user:

• Change admin password:

DEMO - Frontend

http://demo.cmsrs.pl

DEMO - Admin Panel

http://demo.cmsrs.pl/admin-demo

TUTORIALS

https://www.cmsrs.pl/en/cms/cmsrs/cmsrs-video-tutorial

MORE INFORMATION

https://www.cmsrs.pl/en/cms/cmsrs/about-cmsrs

VUE.JS SOURCE CODE

https://github.com/cmsrs/cmsrs3-vuejs

REPORTING ISSUES AND SUGGESTIONS

If you notice any problems or have ideas to improve the project, please use the Issues section to let me know. If you like it, give it a star! Your support motivates me to keep improving the project. Thank you! :)