Gnew Files

// -----------------------------------------------------------------------------
// $Id: readme.txt 150 2018-01-29 16:23:13Z Raoul $
//
// Copyright (C) 2018 Raoul PROENCA
// License: GNU GPL version 3 (see copying.txt file)
// Website: http://www.gnew.xyz/
// -----------------------------------------------------------------------------
// This program is free software: you can redistribute it and/or modify it under
// the terms of the GNU General Public License as published by the Free Software
// Foundation, either version 3 of the License, or (at your option) any later
// version.
//
// This program 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 General Public License for more
// details.
//
// You should have received a copy of the GNU General Public License along with
// this program. If not, see <http://www.gnu.org/licenses/>.
// -----------------------------------------------------------------------------

---------------
| Gnew 2018.2 |
---------------

I. Introduction
II. Requirements
III. Installation
IV. Upgrade
V. Post-installation or post-upgrade


I. Introduction:
----------------

Gnew is a simple Content Management System written with PHP language and using a
database server (MySQL, PostgreSQL or SQLite) for storage. It is fully
customisable since it uses a templates system and supports multiple languages.


II. Requirements:
-----------------

Installation of Gnew requires the following:

- A webserver or web hosting account
- PHP 5.6 or higher (with mail() function and GD library enabled, preferably)
- A MySQL database (5.5 or higher) or a PostgreSQL database (9.2 or higher) or
SQLite 3 database support in PHP

/!\ Important note /!\

If your webserver is running with Suhosin (http://www.hardened-php.net/suhosin/)
make sure to disable sessions encryption.

See http://www.gnew.xyz/articles/read.php?article_id=1#suhosin


III. Installation:
------------------

1) Decompress the Gnew-2018.2 archive to a local directory on your system.

2) Upload all the files (retaining directories structure) to a web accessible
directory on your webserver or hosting account (all .css, .htpl, .js, .php, .sql
and .xml files should be uploaded in ASCII mode).

On Linux / Unix systems:

2.1) Change the permissions of the following directories to be writable by all:
chmod 0755 (drwxr-xr-x) or 0777 (drwxrwxrwx) within your FTP/SSH client,
depending on the PHP server's UID and GID:

  - cache/
  - db/
  - feeds/
  - images/avatars/
  - images/categories/
  - images/emoticons/
  - includes/
  - medias/audios
  - medias/images
  - medias/videos

2.2) Change the permissions of the following files to be writable by all: chmod
0644 (-rwxr-xr-x) or 0666 (-rwxrwxrwx) within your FTP/SSH client, depending on
the PHP server's UID and GID:

  - db/cache.db
  - db/gnew.db
  - all .xml files in the feeds/ directory
  - includes/config.php
  - all .css, .htpl and .js files located in the templates/ directory and its
  subdirectories. You can use the commands below (of course, adapt PATH_TO):

$ cd PATH_TO/templates/
$ find . -regex '.*\.\(css\|htpl\|js\)$' -exec chmod 644 {} \;

3) Using your web browser visit the location where you placed Gnew with the
addition of install/index.php, for example:

http://www.mydomain.tld/install/index.php

4) Fill in all the requested informations.


IV. Upgrade:
------------

1) Backup your current installation and the database tables.

2) Replace old files with the new ones, except files listed below, to any
existing installation.

/!\ Caution /!\

Do not replace the following files:

  - db/gnew.db
  - includes/config.php
  - all .css, .htpl and .js files, located in the templates/ directory and its
  subdirectories, that you have made changes in.

3) Using your web browser visit the location where Gnew is installed with the
addition of install/upgrade.php, for example:

http://www.mydomain.tld/install/upgrade.php

4) Fill in all the requested informations.


V. Post-installation or post-upgrade:
-------------------------------------

1) Remove the install/ directory from your server.

2) Using your favorite editor or from the administration section, edit templates
files located in the templates/ directory and its subdirectories to make your
website looks whatever you want.

Thanks for using Gnew!