.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../Includes.txt


.. _user-manual:

Users Manual (Editors)
======================

Add your Borderstyle to your content element
--------------------------------------------
You have defined a borderstyle. Open your content-element and add the style-class.

.. figure:: ../Images/UserManual/add_class.png
   :width: 500px
   :alt: add a class for borderstyles to your content-element

.. tip::

   A good name describes all characteristics of a style. Think good about your names, because 'doubled' nickname (with different classnames) are allowed.


Define your Borderstyle
-----------------------
- Create a new record *theme of your own borderstyle*~*Theme* (in the sysfolder fpor borderstyles)
.. figure:: ../Images/UserManual/New_Theme_Record.png
   :width: 500px
   :alt: Select a new record for the borderstyle

- Define a CSS-style for your border. The dropdown-field of *width* show some allowed syntax-examples.

.. figure:: ../Images/UserManual/Define_nickname_and_classname.png
   :width: 500px
   :alt: Define a new nickname and classname

- The field *typus* define, how much indiviual style-cdefinition are shown to you. You will see one, two, three or four definitions.

.. figure:: ../Images/UserManual/A_normal_borderstyle_definition.png
   :width: 500px
   :alt: a normal borderstyle definition contain one two three or four definitions depending on type

- The borderstyle with an image is an alternative way to define your border. It has a higher priority than the normal definition. TYPO3 hide the disallowed fields.

.. figure:: ../Images/UserManual/Borderstyle_with_image_hide_other_definitions.png
   :width: 500px
   :alt: The usage of borderstyle with template images will hide other definitions



.. _user-faq:

FAQ
---

Why has a borderstyle-class after the first installation the prefix 'porth-borderstyle'?
````````````````````````````````````````````````````````````````````````````````````````
If you define in this extension a classname for your borderstyle, the extension test the uniqueness of the name in the theme-table. If you want
to use the class-name on your website, the name must be general unique. To grantee this, you define a prefix for all classes of this extension.
You make so the classname nearly 'globally' unique. You can change the prefix in the settings of your typoscript or via the constant-editor.