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

.. _introduction:

Introduction
============

.. only:: html

	:ref:`what` | :ref:`screenshots` |  :ref:`installation`

.. _what:

What does it do?
----------------

Domaincheck is a simple extension to check the availability of domains.

The search result contains links to a given powermail form containing the free domain as parameter.

To keep it as small as possible, the extension make use of several third party extensions (autoloader, typoscript_rendering, vhs).


.. _screenshots:

Example Screenshots
-------------------


Frontend: Search form
^^^^^^^^^^^^^^^^^^^^^

|frontend1|

A form with second level domain to search for and a multi selectbox (using ladda and selectize.js) for tlds


Frontend: Search form with entries
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

|frontend2|

A form with some user input


Frontend: Search result
^^^^^^^^^^^^^^^^^^^^^^^

|frontend3|

Result of a domain search with buttons to a powermail form


Backend: Plugin
^^^^^^^^^^^^^^^

|backend1|

New content element


Backend: Plugin settings
^^^^^^^^^^^^^^^^^^^^^^^^

|backend2|

Example settings to allow only specific tld in frontend


.. _installation:

Installation
------------

Load and install this extension into your TYPO3 installation using extension manager or composer.


Configuration
-------------

First you have to configure the extension inside extension manager. You need e.g. a whois proxy server and the whois command on your server.

|extensionmanager|

Second, add the static template "Main (domaincheck)" to your page template.

Third, add the plugin "Domaincheck" on a page and configure it as you like.

For an order form you can use powermail, with a typoscript field "domain" filled by a typoscript object "lib.domain" and a hidden field "domain_01".

To get it finally working, define this typoscript in your setup:

.. code-block:: typoscript

    // show domain in form
    lib.domain = COA_INT
    lib.domain {
        10 = TEXT
        10 {
            wrap = <div class="form-group"><label class="control-label">Domain</label><p class="form-control-static">|</p></div>
            data = gp:domain
            htmlSpecialChars = 1
        }
    }

    // prefill hidden field "domain_01" with domain
    plugin.tx_powermail {
        settings {
            setup {
                prefill {
                    domain_01 = TEXT
                    domain_01 {
                        data = gp:domain
                        htmlSpecialChars = 1
                    }
                }
            }
        }
    }

Finally thank the author and his suffering family by sending a small ("many a little makes a mickle") or big donation (if you are rich)

https://paypal.me/alexandergrein

Thanks in advance