Warning, /network/konqueror/doc/kcontrol/khtml-adblock/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
0003 "dtd/kdedbx45.dtd" [
0004 <!ENTITY % addindex "IGNORE">
0005 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
0006 ]>
0007 <!-- extragear has another adblock ? -->
0008 <article lang="&language;" id="khtml-adblock">
0009 <articleinfo>
0010 <title>AdBlocK Filters</title>
0011 <authorgroup>
0012 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
0013 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0014 </authorgroup>
0015 
0016 <date>2016-11-08</date>
0017 <releaseinfo>Applications 16.12</releaseinfo>
0018 </articleinfo>
0019 
0020 <para>&konqueror; AdBlocK can be configured to replace or remove
0021 images or frames from web pages that match a series of filters.</para>
0022 
0023 <para>The setting <guilabel>Enable filters</guilabel> enables or
0024 disables the use of list of URL filters.</para>
0025 <para>If <guilabel>Hide filtered images</guilabel> is enabled then
0026 blocked images are completely removed from the page and the space they
0027 occupied is reclaimed. If the option is disabled then a placeholder
0028 image is used in place of filtered images.</para>
0029 
0030 <variablelist>
0031 <varlistentry id="khtml-adblock-manual">
0032 <term><guilabel>Manual Filter</guilabel></term>
0033 <listitem>
0034 <para>The main part of this tab is a list of
0035 URLs that will be compared against image and frame names to decide
0036 on fitlering actions. The wildcards can be given as filename style
0037 regular expressions.</para>
0038 
0039 <para>Each filter can either be expressed as a file style wildcard
0040 string (e.g. http://www.site.com/ads/*) or as a full regular expression
0041 by enclosing the filter with forward slashes (e.g. //(ads|dclk)\./).</para>
0042 
0043 <para>Any filter string can be preceded by <literal>@@</literal> to whitelist 
0044 (allow) any matching &URL;, which takes priority over any blacklist (blocking) 
0045 filter.</para>
0046 
0047 <para><guilabel>Import</guilabel> and <guilabel>Export</guilabel> will 
0048 save or read the current filter list to a plain text file. The file begins with a 
0049 header line <userinput>[AdBlock]</userinput>, then all of the filters follow each 
0050 on a  separate line. Lines prefixed with an exclamation mark (<userinput>!</userinput>) 
0051 and the header line are treated as comments and can be used 
0052 to clarify or label a set of filters.</para>
0053 
0054 <para>Highlight an entry from the list to change it in the edit box or remove this item.
0055 Enter a new filter string here and add it to the list using the <guibutton>
0056 Insert</guibutton> button.</para>
0057 </listitem>
0058 </varlistentry>
0059 
0060 <varlistentry id="khtml-adblock-automatic">
0061 <term><guilabel>Automatic Filter</guilabel></term>
0062 <listitem>
0063 <para>
0064 This tab shows a list of names and &URL;'s with predefined AdBlock filter entries. 
0065 To enable an entry tick the checkbox beside the filter name and adjust the
0066 <guilabel>Automatic update interval</guilabel> (default 7 days).
0067 <!-- how goes it work? After 7 days eachtime going online with konqui the selected 
0068 entries are updated in the background?
0069 User notification about that?
0070 -->
0071 </para>
0072 </listitem>
0073 </varlistentry>
0074   
0075 </variablelist>
0076 
0077 <para>If AdBlock filters are enabled, an icon at the right side of status bar is shown.
0078 Use a &RMB; click on this icon to open the context menu with actions to show all blockable 
0079 elements on a web page, open this &systemsettings; module and disable blocking for a site 
0080 or page temporarily.</para>
0081 
0082 <para>A click with the &LMB; shows the dialog with all blockable elements on the opened web page
0083 as well. From this dialog you can add new filters directly without opening this &systemsettings; 
0084 module.</para>
0085 
0086 </article>