repo_zf1/documentation/manual/en/module_specs/Zend_Application-AvailableResources-Useragent.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect2 id="zend.application.available-resources.useragent">
    <title>Zend_Application_Resource_Useragent</title>

    <sect3 id="zend.application.available-resources.useragent.intro">
        <title>Overview</title>

        <para>
            This resource provides the ability to configure and instantiate <link
                linkend="zend.http.user-agent">Zend_Http_UserAgent</link> for use within your
            application.
        </para>
    </sect3>

    <sect3 id="zend.application.available-resources.useragent.quick-start">
        <title>Quick Start</title>

        <para>
            Using <classname>Zend_Http_UserAgent</classname>, including usage of the application
            resource, is covered in the <link
                linkend="zend.http.user-agent.quick-start">UserAgent quick start</link>. Below is a
            quick summary of typical options you might provide.
        </para>

        <programlisting language="ini"><![CDATA[
resources.useragent.wurflapi.wurfl_api_version = "1.1"
resources.useragent.wurflapi.wurfl_lib_dir = APPLICATION_PATH "/../library/Wurfl/1.1"
resources.useragent.wurflapi.wurfl_config_file = APPLICATION_PATH "/../library/Wurfl/1.1/resources/wurfl-config.php"
]]></programlisting>
    </sect3>

    <sect3 id="zend.application.available-resources.useragent.options">
        <title>Configuration Options</title>

        <para>
            Please see the <link linkend="zend.http.user-agent.options">UserAgent options
                section</link> for details on available options.
        </para>
    </sect3>

    <sect3 id="zend.application.available-resources.useragent.methods">
        <title>Available Methods</title>

        <variablelist>
            <varlistentry id="zend.application.available-resources.useragent.methods.init">
                <term>
                    <methodsynopsis>
                        <methodname>init</methodname>
                    </methodsynopsis>
                </term>

                <listitem>
                    <para>
                        Called by the bootstrap object to initialize the resource. Calls the
                        <methodname>getUserAgent()</methodname> method first (and returns the instance
                        returned by that method); then, if the "view" resource is available, retrieves
                        it and injects the <classname>UserAgent</classname> instance into the
                        <classname>UserAgent</classname> view helper.
                    </para>
                </listitem>
            </varlistentry>

            <varlistentry id="zend.application.available-resources.useragent.methods.get-user-agent">
                <term>
                    <methodsynopsis>
                        <methodname>getUserAgent</methodname>
                    </methodsynopsis>
                </term>

                <listitem>
                    <para>
                        Instantiates a <classname>Zend_Http_UserAgent</classname> instance, using the
                        configuration options provided in the application configuration.
                    </para>
                </listitem>
            </varlistentry>
        </variablelist>
    </sect3>
</sect2>