1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
# Introduction
Xibo - Digital Signage - http://www.xibo.org.uk
Copyright (C) 2006-2015 Daniel Garner and Contributors.
This is the **development branch** and represents the next generation of the Xibo CMS.
At present you cannot upgrade an earlier version to this release.
## 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 from the Repository
The Xibo CMS can be installed from the repository using Composer.
Navigate to the folder where you want to install the CMS, ideally below your web root:
```
cd /var
```
Then clone the repository:
```
git clone git@github.com:xibosignage/xibo-cms.git xibo-cms
```
Install the external dependencies with Composer (visit [getcomposer.org](http://getcomposer.org) for instructions):
```
php composer.phar install
```
## Web Server Configuration
It is highly recommended to use Xibo with URL re-writing enabled. A `.htaccess` file has been provided in `web/.htaccess`.
This file assumes that Xibo is being served from the web server document root or from a virtual host.
If an alias is required then the `.htaccess` file will need to be modified to include a `RewriteBase` directive that matches
the alias.
For example, if the alias is `/xibo` the `.htaccess` should have: `RewriteBase /xibo`.
## Installation Wizard
Visit Xibo in the browser and follow the installation instructions.
# Development
The Xibo CMS now follows MVC and is PSR-4 compliant.
The folder structure is as follows:
- install - Files related to install/upgrade
- lib/Controller - Controllers
- lib/Entity - Models
- lib/Exception - Exceptions
- lib/Factory - Factories for creating Models
- lib/Helper - Helper Classes
- lib/Middleware - Slim Application Middleware
- lib/Storage - Storage Interfaces
- lib/Widget - Controllers for Modules
- lib/Xmds - Xibo Media Distribution SOAP Service
- locale - Translations
- modules/ - Twig Views for Modules and other Module resources
- tests/ - PHPUnit Tests
- views - Twig Views
- web/ - Web Document Root
- web/index.php - Entry point for the WEB GUI
- web/api/index.php - Entry point for the API
- web/maintenance/index.php - Entry point for Maintenance
- web/modules - Web Serviceable Resources for modules
- web/theme - GUI theme files
- web/xmds.php - XMDS SOAP Service
# Contributing
The standard licence for Xibo is the [AGPLv3](LICENSE). For more information please see [CONTRIBUTING.md](CONTRIBUTING.md).
# Repository
This folder contains the Xibo CMS application.
# Vagrant
A VagrantFile is included to ease set up and configuration of a development environment. After `vagrant up` completes
it is necessary to ssh to the box and adjust the `DocumentRoot` of the `000-default.conf` virtual host to be `/var/www/web`.
|