diff --git a/admin_manual/contents.rst b/admin_manual/contents.rst index b00c62f7b..be7c44144 100644 --- a/admin_manual/contents.rst +++ b/admin_manual/contents.rst @@ -27,6 +27,7 @@ Enterprise Subscription Only enterprise_installation/index enterprise_clients/index + enterprise_server_branding/index enterprise_external_storage/index enterprise_user_management/index enterprise_files_drop/index diff --git a/admin_manual/enterprise_server_branding/enterprise_server_branding.rst b/admin_manual/enterprise_server_branding/enterprise_server_branding.rst new file mode 100644 index 000000000..f25c28854 --- /dev/null +++ b/admin_manual/enterprise_server_branding/enterprise_server_branding.rst @@ -0,0 +1,59 @@ +================================= +Custom Theming ownCloud (ES only) +================================= + +Overview +-------- + +ownBrander is an ownCloud build service that is exclusive to Enterprise +subscription customers for creating branded ownCloud clients and servers. You +may brand your ownCloud server using ownBrander to easily build a custom theme, +using your own logo and artwork. ownCloud has always been theme-able, but it was +a manual process that required editing CSS and PHP files. Now Enterprise +customers can use ownBrander, which provides an easy graphical wizard. + +You need an Enterprise subscription, an account on +`Customer.owncloud.com `_, and the +ownBrander app enabled on your account. When you +complete the steps in the wizard the ownBrander service builds your new branded +theme, and in 24-48 hours you'll see it in your account. + +.. figure:: ../images/ownbrander-1.png + :alt: ownBrander app button is on the top left of your ownCloud Web GUI, + after clicking the down arrow at the right of the ownCloud logo + +When you open the ownBrander app, go to the Web tab. You will see an +introduction and the wizard, which starts with uploading your logo. You will +need a number of images in specific sizes and formats, and the wizard tells you +what you need. Example images are on the right, and you can click to enlarge +them. + +.. figure:: ../images/webbrander-1.png + :alt: ownBrander wizard with instructions, upload buttons for your custom + branded images, and example screenshots + +The wizard has two sections. The first section contains all the required +elements: logos and other artwork, colors, naming, and your enterprise URL. The +Suggested section contains optional items such as additional logo placements +and custom URLs. + +When you are finished, click the **Generate Web Server** button. If you want to +change anything, go ahead and change it and click the **Generate Web Server** +button. This will override your previous version, if it has not been created +yet.In 24-48 hours you'll find your new branded theme in the **Web** folder in +your `Customer.owncloud.com `_ account. + +Inside the **Web** folder you'll find a **themes** folder. Copy this to your +``owncloud/themes`` directory. You may name your **themes** folder anything you +want, for example ``myBrandedTheme``. Then configure your ownCloud server to +use your branded theme by entering it in your ``config.php`` file:: + + "theme" => "myBrandedTheme" + +If anything goes wrong with your new theme, comment out this line to re-enable +the default theme until you fix your branded theme. The branded theme follows +the same file structure as the default theme, and you may further customize it +by editing the source files. + +.. Note:: Always edit only your custom theme files. Never edit the default + theme files. \ No newline at end of file diff --git a/admin_manual/enterprise_server_branding/index.rst b/admin_manual/enterprise_server_branding/index.rst new file mode 100644 index 000000000..2520a6c3e --- /dev/null +++ b/admin_manual/enterprise_server_branding/index.rst @@ -0,0 +1,8 @@ +==================================== +Enterprise Server Branding (ES only) +==================================== + +.. toctree:: + :maxdepth: 2 + + enterprise_server_branding \ No newline at end of file diff --git a/admin_manual/images/webbrander-1.png b/admin_manual/images/webbrander-1.png new file mode 100644 index 000000000..e050b15fa Binary files /dev/null and b/admin_manual/images/webbrander-1.png differ