Skip to content

Install and Configure

Warrows edited this page Jul 17, 2014 · 10 revisions

Install PubwichFork

You can download PubwichFork versions as archive (recent version 2.1) and unpack all files to your server; or clone it via Git:

$ git clone git://github.com/haschek/PubwichFork.git pubwichfork
$ cd pubwichfork

You have to change permissions for the cache folder, it must be writeable for the server user scope. You could grant read/write access to all (anonymous) users but it is recommended to grant this rights only to your user and the user group of your www user (for the web server). This example should work under Ubuntu:

$ sudo chown youruser:www-data cache/
$ sudo chmod 6770 cache/

Configure PubwichFork

Configure Application

Copy the config file cfg/config.sample.php to cfg/config.php and edit it by following instructions in the the config file.

cp cfg/config.sample.php cfg/config.php
gedit cfg/config.php

It is recommended to configure at least:

// General site informations
define('PUBWICH_URL', 'http://localhost/pubwich/');
define('PUBWICH_THEME', 'default');
define('PUBWICH_TITLE', 'My Pubwich-powered site');

// Localisation
date_default_timezone_set( 'Europe/Berlin' );
define('PUBWICH_LANG', 'de_DE'); // leave to '' to keep Pubwich in english
setlocale( LC_ALL, 'de_DE.UTF8' ); // for date methods

// Performance - Cache and Timeouts
define( 'CACHE_LOCATION', dirname(__FILE__) . '/../cache/' );
define( 'CACHE_LIMIT', 60 * 60 ); // 60 minutes
define( 'OUTPUT_CACHE_LIMIT', 30 * 60 ); // 30 minutes

Configure Services

You need to configure all web service aggregations in config.php too. Simply fill the blank spaces with your informations (API keys, usernames, site’s URL, etc.) and modify the arguments passed to Pubwich::setServices(). Some basic examples are included in the configuration file. For an extended documentation please see Web Service description.

More Options

Finish Installation

Usually you should be finished here, just test it by calling the URL of your PubwichFork instance in your browser, e.g. if you installed it to /var/www/mypubwichfork it should be accessable via http://localhost/mypubwichfork.

Report Problems

If you are running into problems, then write a message to @haschek or add a bug report to the issue tracker. Thank you!

Clone this wiki locally