.. index::
    single: Ad Translation

.. _ad_translation:

Ad Translation
==============

It is possible to list single Ad in multiple languages by providing translations in every Language.

Below list contain the fields required in every language/locale.

.. apifields::
    .. apifield::
        :name: locale
        :type: string
        :constraints: for Marktplaats only `nl-NL` allowed, for 2dehands: `nl-BE` and `fr-BE` allowed
        :required: true
        :updateable: true
        :writable: true

        Locale (language) of the Translation.

    .. apifield::
        :name: title
        :type: string
        :constraints: max. 60 chars
        :required: true
        :updateable: true
        :writable: true

        Any string with a minimum of 3 characters, up to 60 characters. Urls are not allowed as part of the title.

    .. apifield::
        :name: description
        :type: string
        :constraints: max. 65535 chars
        :required: true
        :updateable: true
        :writable: true

        The description field of the ad. All HTML elements except for the ones below
        will be removed:

        .. code-block:: html

            <i> <em> <b> <strong> <ul> <li> <u> <br/>

        The description can also contain Wiki-formatting. It is recommended to not rely on this feature, since it is probably
        going to change in the future. But since it has impact on how the description is rendered, it is mentioned here.

        We support the following Wikiformatting:

        - Bold: \*\*bold\*\*
        - Italic: //italic//
        - Underline: \_\_underline\_\_
        - Lists:
            ::

                * item1
                * item2

        The result of this support is that it is currently not possible to add the character combinations needed for the
        Wiki formatting literally in the description. So for example, there is currently no way of including ``**hi**``
        in a description, because this will be rendered as bold.