Installation - gLifestream

gLifestream requirements

Django – a Python Web framework
A database supported by Django (e.g. SQLite, MySQL, PostgreSQL).
Universal Feed Parser (python-feedparser)

Optional (but recommended)

Pillow – Python Imaging Library
workerpool – a multithreaded job distribution module
django-pipeline – Pipeline is an asset packaging library for Django
requests-oauthlib – OAuthlib authentication support for Requests
python-markdown – a text-to-HTML converter
Beautiful Soup – an HTML parser
Sphinx – a free open-source SQL full-text search engine

Installation instructions

Change the current working directory into the `glifestream' directory.
Copy `settings-sample.py' to `settings.py' and edit your local site configuration.
Run `python manage.py syncdb'.
Run `python manage.py compilemessages' (if you have `gettext' installed).
Run `./worker.py --init-files-dirs'.

Make sure that `media/thumbs/*' and `media/upload' directories exist and all have write permissions by your webserver.

Use `glifestream/worker.py' to automatically fetch external streams (via cron), list available streams or remove old entries. See `worker.py --help'.

The development/test server

Change the current working directory into the `glifestream' directory and run the command `python manage.py runserver'. You will see the following output:

Performing system checks...

System check identified no issues (0 silenced).
March 09, 2015 - 17:54:57
Django version 1.7.6, using settings 'glifestream.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

Production server with mod_wsgi

Apache configuration:

LoadModule wsgi_module modules/mod_wsgi.so

WSGIScriptAlias / /usr/local/django/glifestream/wsgi.py
Alias /media "/usr/local/django/glifestream/media"
Alias /static "/usr/local/django/glifestream/static"
  
<Directory "/usr/local/django/glifestream/">
   <IfModule mod_deflate.c>
     AddOutputFilterByType DEFLATE application/javascript text/css
   </IfModule>
   AllowOverride All
   Options None
   Order allow,deny
   Allow from all
</Directory>

More detailed information is available at: modwsgi.readthedocs.io

The search functionality via Sphinx

To use the search functionality in GLS via Sphinx, you must add the following configuration to your 'etc/sphinx.conf' (replace the DATABASE_* values with the proper ones from your settings.py):

...
source glifestream
{
   type         = mysql
   sql_host     = DATABASE_HOST
   sql_user     = DATABASE_USER
   sql_pass     = DATABASE_PASSWORD
   sql_db       = DATABASE_NAME
   sql_port     = 3306
   sql_query    = \
	SELECT stream_entry.id, stream_entry.title, stream_entry.content, \
	UNIX_TIMESTAMP(stream_entry.date_published) AS date_published, \
	stream_entry.friends_only, stream_service.public FROM stream_entry \
	INNER JOIN stream_service ON stream_entry.service_id=stream_service.id \
	WHERE stream_entry.active=1 AND stream_entry.draft=0

   sql_attr_timestamp = date_published
   sql_attr_bool      = public
   sql_attr_bool      = friends_only
}

index glifestream
{
   source       = glifestream
   path         = /var/lib/sphinx/glifestream
   docinfo      = extern
   charset_type = utf-8
   html_strip   = 1
}
...

Receive postings via e-mail

To allow for posts sent by e-mail, create a secret mail alias, by extending /etc/mail/aliases file:

...
gls.secret.address: "|/usr/local/django/glifestream/worker.py --email2post"
...

gLifestream