document new Web ownbrander

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

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 <https://customer.owncloud.com/owncloud>`_, 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 <https://customer.owncloud.com/owncloud>`_ 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.   

admin_manual/enterprise_server_branding/index.rst

@@ -0,0 +1,8 @@
+====================================
+Enterprise Server Branding (ES only)
+==================================== 
+
+.. toctree::
+    :maxdepth: 2
+
+    enterprise_server_branding