Note: The following customization guide calls for a basic knowledge of CSS and HTML
You can customize the publications by using your own CSS or LESS files, text files (language specific) and HTML templates.
Use FTP or SCP (e.g. "WinSCP") to access the files. All further paths refer to the root directory of the web application, e.g. "/opt/xyz-manja/htdocs/".
publication_templates/ - contains publication templates , one subdirectory per template
publications/ - the actual publications are stored in this directory, one subdirectory per publication
Manja contains multiple default publication templates. You can use them directly or use them as a starting point to create your own templates.
Image Collections - A list of collections as a self-contained web gallery.
Image Collections NEW - Web gallery, supporting audio and video, optimized for mobile devices.
Image Gallery from Category - A single category as a self-contained web gallery.
Gallery from Category NEW - Category as web gallery, supporting audio and video, optimized for mobile devices.
Web Feeds & Playlists - Media RSS, Atom, XSPF, SMIL, PLS, M3U, JSON.
Please do not change the default templates, your changes will be overwritten in the next software update.
Customizing a publication
Create a publication
Go to the Manja UI, visit "Administration -> Publications" and create a new publication named "example", based on the default template "Image collections".
Now the directory "publications/example" should exist.
The publication is an independently working web application, that communicates directly with the Manja server. The structure of this app is similar to the web application of the Manja UI:
config/ - contains configuration files
locale/ - contains language specific text
skin/ - contains one ore more skins with HTML templates, CSS files and images
lib/, js/, g/, modules/ - various app components
Unlike the Manja UI no custom-mechanism is required here and you can adjust the files directly in "skin/" and "locale/".
Customizing the publication
Images, CSS definitions, text and HTML templates can be customized here:
Some important files (within "publications/example/"):
skin/light/f/styles.css - the main CSS file
skin/light/page.html - the page layout (header, main, footer)
skin/light/main.html - the gallery layout
skin/dark/f/styles.css - CSS file for the "dark" skin
skin/dark/_skin.ini - contains (among others) the definition that the "dark" skin unses the HTML templates of the "light" skin
locale/en.txt - english text
Create own publication templates
Copy a default template
First create a copy of the default publication template. To do so just copy the whole directory.
cp -R picture_collections_1 my_picture_collections
Adjust template settings
The copy is immediately available as publication template. To separate it from the default template you should at least edit title and description of the new template.
To do so edit the file "my_picture_collections/_template.ini" in the section [template] and change the options for "title" and "description". You can either directly set the options "title" and "description" or set their language specific counterparts "title_en", "description_en", "title_de" and "description_de".
You can also change the thumbnail image of the publication template by replacing the file "my_picture_collections/_thumbnail.png".
Customize the template
You can edit text, CSS files, HTML templates and images directly here, or copy them from the publication customized in the previous section.
Changes can be testet a lot easier and faster, if you customize a publication first. So you can check every adjustment directly in the browser. When you are finished just copy your changes into the publication template.
Create a publication based on your new template and test it at length.