.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ============================== EXT: webmasters authentication ============================== :Created: 2010-02-18T17:33:18 :Changed: 2011-09-16T20:09:46.610000000 :Classification: dev_null_webmasters :Keywords: google webmasters, bing webmasters, yahoo sitemanager, multidomain :Author: Wolfgang Rotschek :Email: scotty@dev-null.at :Info 4: :Language: en, de |img-1| |img-2| EXT: webmasters authentication - dev\_null\_webmasters .. _EXT-webmasters-authentication: EXT: webmasters authentication ============================== Extension Key: dev\_null\_webmasters Language: en, de Keywords: google webmasters, bing webmasters, yahoo sitemanager, multidomain Copyright 2000-2010, Wolfgang Rotschek, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: webmasters authentication 1 <#__RefHeading__937_1075929538>`_ **`Introduction 3 <#__RefHeading__939_1075929538>`_** `What does it do? 3 <#__RefHeading__941_1075929538>`_ `Features 3 <#__RefHeading__943_1075929538>`_ `Credits 3 <#__RefHeading__1827_726902644>`_ **`Users manual 4 <#__RefHeading__953_1075929538>`_** `FAQ 4 <#__RefHeading__955_1075929538>`_ **`Authentication with meta tags 5 <#__RefHeading__693_504462887>`_** `Enable meta tags authentication 5 <#__RefHeading__695_504462887>`_ `Typoscript setup 5 <#__RefHeading__697_504462887>`_ **`Authentication with files 6 <#__RefHeading__699_504462887>`_** `Include static extension template 6 <#__RefHeading__701_504462887>`_ `Upload the verification files to your webserver 6 <#__RefHeading__703_504462887>`_ `Typoscript setup 6 <#__RefHeading__705_504462887>`_ `URL-rewriting 6 <#__RefHeading__707_504462887>`_ `Cooluri 6 <#__RefHeading__959_1075929538>`_ `Realurl 6 <#__RefHeading__1202_1613841388>`_ **`Configuration 7 <#__RefHeading__961_1075929538>`_** `Reference 7 <#__RefHeading__963_1075929538>`_ **`Usage 8 <#__RefHeading__709_504462887>`_** **`Known problems 9 <#__RefHeading__967_1075929538>`_** `Feature request & Bugs 9 <#__RefHeading__969_1075929538>`_ **`To-Do list 10 <#__RefHeading__971_1075929538>`_** **`ChangeLog 11 <#__RefHeading__973_1075929538>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: What does it do? ^^^^^^^^^^^^^^^^ This extension assists in the providing of the ownership authentication for various sitemanager platforms. Authentication through meta tags and files is supported. For file authentication realurl or cooluri is required. .. _Features: Features ^^^^^^^^ - Support for multidomain installations - Support for meta tag authentication - Support for stand alone files authentication .. _Credits: Credits ^^^^^^^ .. _Users-manual: Users manual ------------ - Download and install the extension with the extension manager - Configuration of URL-rewriting for your robots.txt .. _FAQ: FAQ ^^^ Possible subsections: FAQ .. _Authentication-with-meta-tags: Authentication with meta tags ----------------------------- For authentication with meta tags the sitemanager platforms expect a meta tag looking like the following example for google webmaster tools: :: . . . . . . . . To use this you have to perform to steps .. _Enable-meta-tags-authentication: Enable meta tags authentication ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the extension configuration enable the meta tags feature |img-3| .. _Typoscript-setup: Typoscript setup ^^^^^^^^^^^^^^^^ Add the following line to the setup of your extension template at the root page of your website :: config.devnullwebmasters.google.metaContent = your verification code .. _Authentication-with-files: Authentication with files ------------------------- This method of authentication reduces the size of your pages because no meta tags have to be written. The following steps are needed to use this. .. _Include-static-extension-template: Include static extension template ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the extension template of your websites root page include the static template dev/null webmasters (dev\_null\_webmasters) |img-4| .. _Upload-the-verification-files-to-your-webserver: Upload the verification files to your webserver ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The verification files have to be uploaded to your webserver. Best method is ftp. I recommend a folder within the fileadmin directory (e.g. fileadmin/webmasters) .. _Typoscript-setup: Typoscript setup ^^^^^^^^^^^^^^^^ Add the following line to the setup of your extension template at the root page of your website :: config.devnullwebmasters.google.fileName = fileadmin/webmasters/google123456789abcdf.html The filename varies and is on most installations case sensitive. .. _URL-rewriting: URL-rewriting ^^^^^^^^^^^^^ To use file verification the url (e.g. www.yourdomain.tld/index.php?id=1&type=1966&webmasters=google) has to be rewritten to match the webmasters tool. Depending on the system the configuration varies. .. _Cooluri: Cooluri """"""" If you use the extension cooluri for URL-rewriting you have to define the link for each domain and file where you like to use site authentication |img-5| The parameter id represents the id of the websites (domain) rootpage. The value for the parameter webmasters corresponds with the properties in the TS-Setup. .. _Realurl: Realurl """"""" For details how to do this please look at the documentation of RealUrl. .. _Configuration: Configuration ------------- Typo script default configuration. .. _Reference: Reference ^^^^^^^^^ .. ### BEGIN~OF~TABLE ### .. _typeNum: typeNum """"""" .. container:: table-row Property typeNum Data type int Description typeNum for the TS-page object, responsible for the verification files Default 1966 .. ###### END~OF~TABLE ###### [tsref:config.devnullwebmasters] .. _generated: ((generated)) """"""""""""" .. _Google: Google ~~~~~~ .. ### BEGIN~OF~TABLE ### .. _contentType: contentType ''''''''''' .. container:: table-row Property contentType Data type string Description Content type of google verification files Default text/html .. _fileName: fileName '''''''' .. container:: table-row Property fileName Data type string Description File path to verification file Default .. _metaName: metaName '''''''' .. container:: table-row Property metaName Data type string Description Meta name attribute for google Default google-site-verification .. _metaContent: metaContent ''''''''''' .. container:: table-row Property metaContent Data type string Description Meta content attribute for google holds the verification code Default .. ###### END~OF~TABLE ###### [tsref:config.devnullwebmasters.google] .. _Yahoo: Yahoo ~~~~~ .. ### BEGIN~OF~TABLE ### .. _contentType: contentType ''''''''''' .. container:: table-row Property contentType Data type string Description Content type of yahoo verification files Default text/html .. _fileName: fileName '''''''' .. container:: table-row Property fileName Data type string Description File path to verification file Default .. _metaName: metaName '''''''' .. container:: table-row Property metaName Data type string Description Meta name attribute for yahoo Default y\_key .. _metaContent: metaContent ''''''''''' .. container:: table-row Property metaContent Data type string Description Meta content attribute for yahoo holds the verification code Default .. ###### END~OF~TABLE ###### [tsref:config.devnullwebmasters.yahoo] .. _Bing: Bing ~~~~ .. ### BEGIN~OF~TABLE ### .. _contentType: contentType ''''''''''' .. container:: table-row Property contentType Data type string Description Content type of bing verification files Default text/xml .. _fileName: fileName '''''''' .. container:: table-row Property fileName Data type string Description File path to verification file Default .. _metaName: metaName '''''''' .. container:: table-row Property metaName Data type string Description Meta name attribute for bing Default msvalidate.01 .. _metaContent: metaContent ''''''''''' .. container:: table-row Property metaContent Data type string Description Meta content attribute for bing holds the verification code Default .. ###### END~OF~TABLE ###### [tsref:config.devnullwebmasters.yahoo] .. _Usage: Usage ----- You can easily add additional tools to add a platform just define a key which is required in case of file verification and add the additional properties. Example for a platform mySitemanager with meta tags. We will use the key mysite. We assume the site manage expects the following meta tag: :: The the TS-Setup for meta validation looks like the following: :: Config.devnullwebmasters.mysite { metaName = mySiteManager metaContent = validate1234 } .. _Known-problems: Known problems -------------- Extension must be loaded after extension sourceopt .. _Feature-request-Bugs: Feature request & Bugs ^^^^^^^^^^^^^^^^^^^^^^ If you find a bug or a missing feature, please add it to the bugtracker of the extension at forge. The address is: `http://forge.typo3.org/projects/extension- dev\_null\_webmasters/issues `_ For posting a bug or feature request you need an account of typo3.org. .. _To-Do-list: To-Do list ---------- .. _ChangeLog: ChangeLog --------- .. ### BEGIN~OF~TABLE ### .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes Initial upload .. ###### END~OF~TABLE ###### |img-2| 12 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.png .. :align: left .. :border: 0 .. :height: 101 .. :id: Grafik4 .. :name: Grafik4 .. :width: 382 .. |img-4| image:: img-4.png .. :align: left .. :border: 0 .. :height: 208 .. :id: Grafik3 .. :name: Grafik3 .. :width: 551 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 177 .. :id: Grafik1 .. :name: Grafik1 .. :width: 480