php-e107/README.md

[![e107 Content Management System](e107_images/logoHD.png)](https://e107.org)
=================

[![GitHub release](https://img.shields.io/github/v/release/e107inc/e107?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAQAAAD9CzEMAAAAAmJLR0QA/4ePzL8AAAAJcEhZcwAALiMAAC4jAXilP3YAAAAHdElNRQfjDBwRCAhY3Q3XAAAAGXRFWHRDb21tZW50AENyZWF0ZWQgd2l0aCBHSU1QV4EOFwAAA8hJREFUWMOtlltMVFcUhhcDGC+YalXSpI1Kqtg0jMVLTS9p0tcahkTb+GRi65MvfRWN+tL60kuqsU+mxtLYpIQOIBYhNJZYQY2RFrVoNWICioYWOpFhBqQw8/kwnH32Ppe5Mftp5uy1/3+t/19n7SOS5eIFDtNHhAh3OUaFFHaxkX709Q/bCwlfxRDONcXOwmXvhgeYZEch4IM+8ADP5l0FVTwyIPvoIVmwKlziHKJEhI+IG17sKJQ4dWqn1kGxM7/sH3rDi4gQYnJeQhFk0B9+ropY3lVQlS57H6Gyr8JlbZ1vZCgPu/2tzaKKzEIRdIhzIGNCtTnY7cp+f1aShhLxrN7u7Kz1rmI4s92ZreV9vqaDVo6w0V3F9Xgsnd2ugewQh5do0XanOU6JGTESOh8b87M7k7WUc801Sc9QbEb11jZORbyEcmXvEIe1XPcc1s2UmZGXa8PxUd3u7SJCGX+mhV/HPbV3m085wBP1v91N0RT/V79YVwufZIC/q/Z6KBcRoVq7IzpYYp64GDIovhQaNfjPHfCvavDdrPTsuPMsNU9d2hWeVh11Q7isQqO8nCb7FcZepfaV0e6s4vf+H629/4QuzZQtBvzfXtmr/QqDQvPi5tKuR03WzrBwQpPoakplR/Ye8CIi3Wu4rQk1R0HgwpkGG/FX4W3D5KuUu+BfVFm/wYfs4k2KUv9b12pVdLBEJFn6W/1POt5uEeG4QXGRzdxxZ882OpkGIMEl3k09barQqmhjVeP37TpWE6UiQjGn1KNZOrnvtpYaJow0YtR4VNGZaBu2Y1pYbJUe4DuAqUTvOS28W4Of9Piu86LoSDYr+IV6TxRxkjB1mjg9Spwadb2P8RVfMKKq2K0o7HOdyYP0adkbjXnTM3tr1j9OtTEbVAPP8rGi+EudbWU5pd4XzojL2pAGX6294RZFUqPo9xsfzrH9iwZviTPMZscQsShmLIoLq+kBznqIox3cwj7127b2CZtckTZFwqIYWMRe52RKc5Wr7B8S9Iyw3+QEe3L9dNym+n6IrSzwiapUbTHNe7kRtCn4Kk7Sa80oLaLk5waaWc+NuchjuRFsZRAYIhj/FoArJgWB0R/CAA1UcgtoYVmuIlXTxWvs08agfeGUUG91NEd5hW/Sdk4akhVE3cOcAPXa01nWSL6LMk4b8+cPPuAdwsazc/Y4z4eiSJu0XsscaXlRzE1aH/jFMv/lS3F23tnbQj07NU6UKBEiTDDOU6ZaWCSFWwT+PzoQf8Ad7jHA4Ez0dEHhU2vm9dhBGmgc+4y3sj/1HPOcQpNXqqPqAAAAAElFTkSuQmCC)](https://github.com/e107inc/e107/releases)
[![GitHub Workflow "Unit Tests" Status](https://img.shields.io/github/workflow/status/e107inc/e107/Unit%20Tests?logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABMAAAAOCAQAAABnEe8CAAAAAnNCSVQICFXsRgQAAAAJcEhZcwAAA3cAAAN3Aa+SYCgAAAAZdEVYdFNvZnR3YXJlAHd3dy5pbmtzY2FwZS5vcmeb7jwaAAABG0lEQVQoFW3By0pUARgA4H8O05AQZWjkImjprr0LL7guJ3VcidAmkFZBi0AHDyNCtu4FeoF6hbQLw5CiKIX2BLWa0+jshj6P13Tq++KUfjWbDrTtWnUvrnAzjpmU2Vc14aGXdhwaizP6VNyKCFM6qirWNR2qe2ROT+Qk5qWKEeGO36peaxiWKBnx3u3IGVL3NE5Ztqei4breuOCut34ajnO2LfpoJMIDqWKEoucy2+7HX1rKMknkvPHZjF28cyMu01KWSSKn1y/8UVOIq2ypWjcaJzzRNhP/UrNn2lc9kVMwqKQU3fTLLHnlu3GJgiGfPFOIbh7rSE1b09T0xawXPrgW3ZQ1/ZAqm7Dgm5bZ+B99UhtaDmxZMRBdjgBnPOGTaoNcdgAAAABJRU5ErkJggg==)](https://github.com/e107inc/e107/actions)
[![Code coverage](https://img.shields.io/codeclimate/coverage/e107inc/e107?logo=code-climate)](https://codeclimate.com/github/e107inc/e107/test_coverage)
[![Join the chat at https://gitter.im/e107inc/e107](https://img.shields.io/gitter/room/e107inc/e107?logo=gitter&color=ED1965)](https://gitter.im/e107inc/e107?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Download e107](https://img.shields.io/sourceforge/dt/e107.svg)](https://sourceforge.net/projects/e107/files/latest/download)

**[e107][1]** is a free and open-source content management system (CMS) which allows you to manage and publish your content online with ease. Developers can save time in building websites and powerful online applications. Users can avoid programming completely! Blogs, websites, intranets – e107 does it all. 

## Table of Contents

   * [e107 Content Management System](README.md)
      * [Table of Contents](#table-of-contents)
      * [Requirements](#requirements)
         * [Minimum](#minimum)
         * [Recommended](#recommended)
      * [Installation](#installation)
         * [Standard Installation](#standard-installation)
         * [Git Installation (developer version)](#git-installation-developer-version)
      * [Reporting Bugs](#reporting-bugs)
      * [Contributing to Development](#contributing-to-development)
      * [Donations](#donations)
      * [Support](#support)
      * [License](#license)

## Requirements

   ### Minimum

   * A web server (Apache or Microsoft IIS) running PHP 5.6 or newer
   * MySQL 4.x or newer, or MariaDB
   * FTP access to your web server and an FTP client (such as FileZilla)
   * Username and password to your MySQL database

   ### Recommended

   * Apache 2.2 or newer on Linux with PHP 7.0 or newer
   * MySQL 5.x or newer, or MariaDB
   * A registered domain name
   * Access to a server control panel (such as cPanel)


## Installation 

### Standard Installation

1. [Download e107](https://e107.org/download).
2. Unzip/Extract the compressed file onto your desired web root.
   This is often a folder called `public_html`. 
3. Point your browser to the `install.php` script (e.g., `https://example.com/subfolder/install.php`)
4. Follow the installation wizard in your browser.



### Git Installation (developer version)

1. Run the following commands, replacing '~' with your document root (the parent of `public_html`) and xxx:xxx is the intended owner of your e107 files.
   ```
   cd ~
   git clone https://github.com/e107inc/e107.git public_html	
   chown -R xxx:xxx public_html 
   ```    
2. Point your browser to the `install.php` script (e.g., `https://example.com/subfolder/install.php`)
3. Follow the installation wizard in your browser.



## Reporting Bugs

Be sure you are using the most recent version of e107 prior to reporting an issue.
You may report any bugs and make feature requests [e107's GitHub Issues page](https://github.com/e107inc/e107/issues).



## Contributing to Development

* Please submit 1 pull request for each GitHub issue you work on. 
* Make sure that only the lines you have changed actually show up in a file-comparison (diff).
  Some text editors alter every line; this should be avoided. 
* It is recommended to configure `git pull` to rebase on the master branch by default to avoid unnecessary merge commits.  You can set this up in your copy of the repo's `.git/config` file like so:
  ```
  [branch "master"]
    rebase = true
  ``` 
* See the [CONTRIBUTING](.github/CONTRIBUTING.md) document for a tutorial on getting started.

## Donations
If you like e107 and wish to help it to improve, please consider making a small donation.

* PayPal: donate (at) e107.org



## Support
* https://e107help.org



## License

e107 is released under the terms and conditions of the GNU General Public License (http://www.gnu.org/licenses/gpl.txt)

  [1]: https://e107.org