<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>

<article lang="&language;">
<title
>Browser Identification</title>
<articleinfo>
<authorgroup>
<author
>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
<othercredit role="translator"
><firstname
>John</firstname
><surname
>Knight</surname
><affiliation
><address
><email
>anarchist_tomato@herzeleid.net</email
></address
></affiliation
><contrib
>KDE British Conversion</contrib
></othercredit
> 
</authorgroup>

<date
>2003-10-12</date>
<releaseinfo
>3.2</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KControl</keyword>
<keyword
>user agent</keyword>
<keyword
>browser</keyword>
<keyword
>identification</keyword>
</keywordset>

</articleinfo>

<sect1 id="user-agent">
<title
>Browser Identification</title>


<sect2 id="user-agent-intro">
<title
>Introduction</title>

<para
>When &konqueror; connects to a web site to retrieve information, some basic identifying information is sent to the web site in the form of a <quote
>User Agent</quote
> header.</para>

<para
>Because of minor differences in the way that different web browsers function, web sites that rely too much on a single browser may sometimes not display as intended when viewed using another browser. Some web sites are smart enough to examine the contents of the user agent header and incorporate this information in the <acronym
>HTML</acronym
> code so that the content is displayed correctly regardless of the browser used.</para>

<para
>However, you may find that some web sites refuse to function correctly unless you are using a browser recognised as <quote
>proper</quote
> by that site. In these cases, you may find it necessary to fool the web site by having &konqueror; report itself to be another browser by means of the user agent header.</para>

</sect2>

<sect2 id="user-agent-use">
<title
>Use</title>

<para
>In this module you can configure the type of browser that &konqueror; will report itself to be. You can control this information by web site. Usually, the list box that is labeled <guilabel
>Site/Domain Specific Identification</guilabel
> will be empty, so that &konqueror; will always use its default useragent string.</para>

<para
>You can disable the sending of a user agent entirely, by unchecking the <guilabel
>Send identification</guilabel
> checkbox. This may cause strange behaviour on some sites, and may even deny you access to some websites, so disable this with caution.</para>

<para
>To configure a new agent binding, press the <guibutton
>New...</guibutton
> button. Type the name of the server or a domain in the text box at the top of the dialogue that pops up, which is labelled <guilabel
>When browsing the following site</guilabel
>.</para>

<para
>Note that you can <emphasis
>not</emphasis
> use the wildcard character <token
>*</token
> in this text box. However, the string <userinput
>kde.org</userinput
> will match all hosts in the domain <systemitem
>kde.org</systemitem
></para>

<para
>After typing the name of the server, type in the identifying string in the next combo box, which is labeled <guilabel
>Use the following identity:</guilabel
>, or choose a string from the list. If you don't choose a string from the list, you will need to know what a valid string from the browser looks like. For example, you could type <userinput
>Mozilla/4.0 (compatible; MSIE 4.0)</userinput
>. </para>

<para
>In the field labelled <guilabel
>Alias (description)</guilabel
> you can enter a descriptive name for the configured binding, &eg; <userinput
>Netscape Navigator 4.75 on Linux</userinput
> for the useragent string <userinput
>Mozilla/4.75 (X11; U; Linux 2.2.14 i686)</userinput
>.</para>

<para
>You can click on an existing entry in the <guilabel
>Configured agent bindings</guilabel
> list, and then modify the contents of the text boxes, followed by clicking <guibutton
>Change...</guibutton
>.</para>

<para
>The <guibutton
>Delete</guibutton
> button can be used to delete the selected entry in the list of configured agent bindings. The <guibutton
>Delete All</guibutton
> will remove all the configured user agent strings. Click the <guibutton
>Apply</guibutton
> to take your changes in effect.</para>

<para
>You can use the checkboxes at the top of the screen to build a user agent that is uniquely yours, by choosing your own combination of operating system name and version, platform, processor type, and language.</para>

<para
>In all cases, the user agent that is being sent by default is displayed in bold text at the top of the page.</para>

</sect2>

</sect1>

</article>