Need help with xibo-cms?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

xibosignage
256 Stars 189 Forks GNU Affero General Public License v3.0 8.0K Commits 3 Opened issues

Description

Xibo Content Management System

Services available

!
?

Need anything else?

Contributors list

Introduction

Xibo - Digital Signage - https://xibo.org.uk Copyright (C) 2006-2021 Xibo Signage Ltd and Contributors.

Branches

  • develop: Work in progress toward 3.0
  • master: Currently 2.3
  • release23: Bug fixes for 2.3
  • release22: Bug fixes for 2.2
  • release18: Work in progress toward the next 1.8
  • release17: Archive of 1.7
  • release1.6.4: Archive of 1.6

Licence

Xibo is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.

Xibo is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with Xibo. If not, see http://www.gnu.org/licenses/.

Installation

Installing an official release is described in the manual and in the release notes of each release.

Developing

Please only install a Development environment if you intend make code changes to Xibo. Installing from the repository is not suitable for a production installation.

Xibo uses Docker to ensure all contributors have a repeatable development environment which is easy to get up and running.

The very same Docker containers are used in our recommended end user installation to promote consistency from development to deployment.

To these ends this repository includes a

docker-compose.yml
file to spin up a model development environment.

Prerequisites

The development Docker containers do not automatically build vendor files for PHP or JS, this is left as a developer responsibility. Therefore you will need the following tools:

  • Git
  • Composer
  • NPM (coming in 2.0)
  • Docker

Clone the repository

Create a folder in your development workspace and clone the repository. If you intend to make changes and submit pull requests please Fork us first and create a new branch.

git clone [email protected]:/xibo-cms.git xibo-cms

Install dependencies

Change into your new folder

cd xibo-cms

We recommend installing the dependencies via Docker, so that you are guarenteed consistent dependencies across different development machines.

PHP dependencies

docker run --interactive --tty --volume $PWD:/app --volume ~/.composer:/tmp composer install

This command also mounts the Composer

/tmp
folder into your home directory so that you can take advantage of Composer caching.

Website dependencies (webpack)

docker run -it --volume $PWD:/app --volume ~/.npm:/root/.npm -w /app node:12 sh -c "npm install webpack -g; npm install; npm run build;"

Mapped Volumes

The development version of Xibo expects the code base to be mapped into the container such that changes on the host are reflected in the container.

However, the container itself creates some files, such as the twig cache and library uploads. These locations will need to be created and the container given access to them.

The easiest way to do this is to make the

cache
and
library
folders and
chmod 777
them. Obviously this is not suitable for production, but you shouldn't be using these files for production (we have containers for that).

API Keys

The API requires a pub/private RSA keypair and an encryption key to be provided. The docker entrypoint will create these in

/library/certs
.

You can override the generated keys paths and encryption key by providing an alternative in

settings-custom.php
. For example:
$apiKeyPaths = [
    'publicKeyPath' => '/var/www/cms/custom/public.key',
    'privateKeyPath' => '/var/www/cms/custom/private.key',
    'encryptionKey' => ''
];

Bring up the Containers

Use Docker Compose to bring up the containers.

docker-compose up --build -d

Login

After the containers have come up you should be able to login with the details:

U:

xibo_admin
P:
password

Translations

To parse the translations:

docker-compose exec web sh -c "cd /var/www/cms; rm -R ./cache"
docker-compose exec web sh -c "cd /var/www/cms; php bin/locale.php"
find ./locale ./cache ./lib ./web  -iname "*.php" -print0 | xargs -0 xgettext --from-code=UTF-8 -k_e -k_x -k__ -o locale/default.pot

To import translations:

bzr pull lp:~dangarner/xibo/swift-translations

Convert to

mo
format:
for i in *.po; do msgfmt "$i" -o $(echo $i | sed s/po/mo/); done

Move the resulting

mo
files into your
locale
folder.

Swagger API Docs

To generate a

swagger.json
file, with the dev containers running:
docker-compose exec web sh -c "cd /var/www/cms; vendor/bin/swagger lib -o web/swagger.json"

Application Structure

To find out more about the application code and how everything fits together, please refer to the developer docs.

Contributing

The standard licence for Xibo is the AGPLv3. For more information please see CONTRIBUTING.md.

Reporting Problems

Support requests can be reported on the Xibo Community Forum. Verified, re-producable bugs with this repository can be reported in the Xibo parent repository.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.