johncms/johncms

Content Management System

9.6.0 2021-07-18 10:28 UTC

This package is auto-updated.

Last update: 2024-05-04 20:19:05 UTC


README

GitHub Source Code GitHub tag (latest SemVer)

PHP-CI Crowdin

This version is at an early stage of development. Many things may not work or work not as intended.

System requirements

  • PHP 8.1 and higher
  • MySQL 5.7
  • PHP configured to use MySQL Native Driver (mysqlnd)
  • .htaccess support or any server configured to forward requests to /public/index.php

Installation

To install the general availability version, go to the project website and download the latest available distributive. Then follow the installation instructions that came with it.

To install the developer version, you must have a Composer dependency manager, NodeJS and GIT version control system.

  1. Clone or download this repository on local workstation.
  2. Assign the repository folder as Apache virtual host, or move contents to the previously created virtual host folder.
  3. Create MySQL Database.
  4. Open the console in the virtual host folder and install the dependencies using the command
npm install && composer install && npm run build
  1. Open the url in your browser (replace your.site to your virtualhost name): http://your.site/install and follow the instructions in the installer.
  2. This is all done. If you go to the address of your virtual host from the browser, you should see a working site with demo data.

Installation in Docker

To install the developer version, you must have a Docker and GIT version control system.

  1. Clone or download this repository on local workstation.
git clone https://github.com/johncms/johncms.git johncms
cd johncms
  1. Start the container
docker-compose up -d
  1. Open the container console.
docker exec -it $(docker ps -q -f name=ubuntu) bash
  1. Build assets and install dependencies
npm install && composer install && npm run build
  1. Install the system in your browser using the following data

    Open the address http://localhost:8000

    DB Host: mariadb

    DB Name: johncms

    DB User: johncms

    DB Password: password

Problems and solutions

When you get updates from the repository, you need to follow the changes of some files.

  • If composer.json has been changed, you need to run the command composer install.
  • After updating or after changing routes, run the command php johncms cache:clear.

Also, after performing the update, you can run the following command:

make cms-update