To use the theme-example
app, clone or download this repository to the owncloud/apps
folder on your server. Please note that the Apache user needs access rights to the folder and its content. As an example, use the following command to adjust the permissions: chown -R www-data:www-data theme-example
.
When you download this repository the extracted folder name will be theme-example-master
. You must change the folder name to theme-example
to get the theme working out of the box.
If you change the name of the app (the folder name) from theme-example
to another name, be sure to change the <id>
in the file appinfo/info.xml
as well. The folder name and the <id>
must be identical.
To edit images it is best to open the original images from the core\img
folder with Gimp or Photoshop. After you have made changes, overwrite the originals.
Please note that the browser stores images in the cache, so this should always be deleted after changes. (https://en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache)
Please have a look at the file defaults.php
if you want to change texts. The copyright text on the start page and other texts are well documented there.
In the file core/css/styles.css
you will find the adjustments we have preconfigured for you. You can change everything you want there. More classes and their values can be found easily with the browser console (F12 key). There you can also test directly in the browser how the change of values will be reflected. If it fits you can transfer the values to styles.css
.
Since files in the theme must be changeable, it has not been signed by us. Therefore an integrity check warning
appears in your ownCloud instance. You can deactivate it for the theme-example
app by adding following config parameter to config/config.php
. You can find the config directory in the root folder of your instance.
'integrity.ignore.missing.app.signature' => [
'theme-example',
],
If you have any questions you can ask them on https://central.owncloud.org.
We are happy to help.
Sincere thanks goes to the awesome https://unsplash.com site for the background image. (Photo by Kaushik Panchal on Unsplash)