Updated readme with installation advice

Passing variables in is now supported via filters, also added a defau…

…lt var @themeurl for use in image paths

Fixed a typo and completed the PHPDOC comments properly