Return home

· 2010-01-29

Storytelling with Storytlr

I thought it would be wise to document how I installed Storytlr as I feel the official documentation doesn’t list everything.

The basic requirements to get storytlr working are – Apache, MySQL, PHP5 (with php5-tidy, and php5-mcrypt).  So once you have the basic system requirements met, the next step is to download the latest stable release from here and extract the tarball in your target directory.

So in your virtual host file make sure you have enabled AllowOverride

(I set mine to ALL), this will mean that apache takes note of the .htaccess.  I also had to add Options FollowSymlinks to the .htaccess, just underneath .

Next create your database using your preferred method (phpmyadmin/mysqladmin/voodoo).  Once created you need to populate it with the basic info, so cd $PATH/TO/INSTALL/protected/install/

and run mysql -u $USER -p -D $DB_NAME < database.sql

So the database is ready and waiting for you now, next step is to edit the basic config information.

There is a sample file ready for you to edit, so first thing is cd $PATH/TO/INSTALL/protected/config/

and copy the sample cp config.ini.sample config.ini

Now open config.ini in your preferred editor. The key items to change are:

Finally make sure you web server has the correct permissions to access the files

chown -R wwwrun:www $PATH/TO/INSTALL (replace wwwrun:www with whatever your distro uses if not on openSUSE).

So once all that is done just head over to your new site. You can log in via the little key icon in the top right or just append /admin to your url. The default credentials are user=admin password=storytlr please make sure you change the password once logged in.

So that’s the install done, what about making sure the feeds saty up to date? Well the only way of doing that is to set up a cronjob, not painful at all but not as automated as I’d have liked. I’ve chosen to update every 7 minutes because there is so much going on in my web 2.0 life :-P

So basically choose your timing for updating your streams, and then run the update.php script located in the protected/tools directory telling it which user to update for. My cronjob looks like:

*/7 * * * * php5 $PATH/TO/INSTALL/protected/tools/update.php admin

There are several additional plugins available:

Each plugin has instructions on how to install, but they are pretty simple. In essence you’ll need to do a git clone of the repository housing the plugin, rename the directory, add the database entries to you installation, copy the icon to the images directory, and off you go! If you are interested in creating a new plugin, I recommend you look at John Hobbs’ little guide.

Ryan Paul of Ars Technica and Gwibber fame did a piece on storytlr which pushed me to trying it. As you can see from Ryan’s site he has implemented a few modifications like tangofying the icon set, and also looks like he created a Launchpad plugin.

I have a few issues but none of them are in anyway show stoppers, and I’m actually enjoying the simplicity of it all :-D

Back to top

Categories: OpenSource

Tags: openSUSE, Server, Software, Web