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

.. include:: ../../Includes.txt


.. _registering-user-function:

Registering the provider
------------------------

As shown in section :ref:`screenshots`, you have the opportunity to register your provider and add it to the selector of
registered providers:

.. figure:: ../../Images/registered_providers.png
	:alt: Registered providers

Sample code to be added to your :file:`ext_tables.php` file:

.. code-block:: php

	if (TYPO3_MODE === 'BE') {
	    $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['direct_mail_userfunc']['userFunc'][] = array(
	        'class'  => 'yourClass',
	        'method' => 'yourMethod',
	        'label'  => 'Some Label'
	    );
	}

This will add a new entry "Some Label" that fills in provider ``yourClass->yourMethod`` when selected:

.. figure:: ../../Images/new_provider.png
	:alt: New provider

.. tip::

	- Parameter ``label`` of the registration code supports a localized label definition such as
	  ``LLL:EXT:direct_mail_userfunc/Resources/Private/Language/locallang.xlf:`` ``userfunction.myRecipientList``
	- Providers are automatically sorted by label in the selector