[github/wallabag/wallabag.git] / INSTALL.md

# Installing poche

## you don't want to install twig (the template engine) by yourself

Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip

Extract this file on your server.

## you want to install twig by yourself 

Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche

Extract this file on your server.

```php
curl -s http://getcomposer.org/installer | php
php composer.phar install
```

### using sqlite

Copy / paste install/poche.sqlite in db folder.

### using mysql or postgresql

Execute the sql file in /install (mysql.sql or postgres.sql)

Then, go to step 3.

# Upgrading poche

Replace all the files except **db/poche.sqlite**. Also remember to edit the file /inc/poche/config.inc.php.

## Upgrading from poche <= 0.3

You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php

Then, go to step 3.

## Upgrading from poche >= 1.0 beta1

Nothing to do here. 

Then, go to step 3.

# Here is the step 3

You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.

You can use poche ! Enjoy.

# Some problems you may encounter

## Blank page

Be sure to have write access on assets, cache and db directories.

## PHP Fatal error:  Call to a member function fetchAll() on a non-object in /var/www/poche/inc/poche/Database.class.php on line 42

If you want to install poche, delete the db/poche.sqlite file and copy / paste the install/poche.sqlite in /db. Be sure to have write access.
Commit	Line	Data
1d517de6 NL	1	# Installing poche
1d517de6 NL	2
f93aaa65	3	## you don't want to install twig (the template engine) by yourself
1d517de6	4
f93aaa65	5	Download this file http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip
1d517de6	6
f93aaa65	7	Extract this file on your server.
1d517de6	8
f93aaa65	9	## you want to install twig by yourself
1d517de6	10
f93aaa65	11	Download the latest version here : http://www.inthepoche.com/?pages/T%C3%A9l%C3%A9charger-poche
1d517de6	12
f93aaa65	13	Extract this file on your server.
145f5040	14
f93aaa65	15	```php
145f5040	16	curl -s http://getcomposer.org/installer \| php
145f5040 NL	17	php composer.phar install
	18	```
	19
f93aaa65 NL	20	### using sqlite
	21
	22	Copy / paste install/poche.sqlite in db folder.
	23
	24	### using mysql or postgresql
	25
	26	Execute the sql file in /install (mysql.sql or postgres.sql)
	27
	28	Then, go to step 3.
	29
	30	# Upgrading poche
	31
	32	Replace all the files except db/poche.sqlite. Also remember to edit the file /inc/poche/config.inc.php.
	33
	34	## Upgrading from poche <= 0.3
	35
	36	You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php
	37
	38	Then, go to step 3.
	39
	40	## Upgrading from poche >= 1.0 beta1
	41
	42	Nothing to do here.
	43
	44	Then, go to step 3.
	45
	46	# Here is the step 3
145f5040	47
f93aaa65	48	You must have write access on assets, cache and db directories. These directories may not exist, you'll have to create them.
1d517de6	49
f93aaa65	50	You can use poche ! Enjoy.
1d517de6	51
f93aaa65	52	# Some problems you may encounter
1d517de6	53
f93aaa65	54	## Blank page
1d517de6	55
f93aaa65	56	Be sure to have write access on assets, cache and db directories.
1d517de6	57
f93aaa65	58	## PHP Fatal error: Call to a member function fetchAll() on a non-object in /var/www/poche/inc/poche/Database.class.php on line 42
1d517de6	59
f93aaa65	60	If you want to install poche, delete the db/poche.sqlite file and copy / paste the install/poche.sqlite in /db. Be sure to have write access.