summaryrefslogtreecommitdiffstats
path: root/doc/kcontrol/useragent/index.docbook
blob: 14be0fcf28204ea19251532bd0894213a0f8e167 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<?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 % English "INCLUDE" > <!-- change language only here -->
]>

<article lang="&language;">
<title>Browser Identification</title>
<articleinfo>
<authorgroup>
<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</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 recognized 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 behavior 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 dialog that pops up, which
is labeled <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 labeled <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>