# Plugins

## &Netscape; Plugins

Currently, &konqueror; supports &Netscape; plugins.

Selecting Settings Configure Konqueror... opens the configuration dialog. Select the Plugins page, where you find two tabs; Global Settings to enable plugins and configure how they are used in &konqueror; and the Plugins which shows you the &Netscape; plugins that &kde; has found and allows you to scan for plugins.

For more information see the Browser Plugins help page.

## &konqueror; Plugins

&kde; releases several useful plugins that interact with &konqueror; in various ways. These are explained briefly below.

Use Settings Configure Extensions... to open a dialog with all installed plugins and select the ones you need. All plugins are accessible in the Tools menu.

Only plugins appropriate for the current mode (file manager or browser) are listed in the dialog.

## Browser Mode

Web Page Translation

- This uses the machine translation service provided by Yahoo's BabelFish site to translate the current HTML page to whatever language you want (within reason). It can be launched with Tools Translate Web Page.

  If you have a portion of the text on the page selected, that will be translated instead of the entire &URL;.

  Not all languages are available from the Babelfish service.

  Machine translation is not a perfect science! Babelfish will at best give you a rough translation, and at worst will give you a very funny read. Don't base important decisions on things you have read from a Babelfish translated page, without confirming that the translation is indeed accurate.

  You may only translate web pages that are accessible on the world wide web. To translate any other text, you should go directly to the Babelfish site itself, where you are able to paste in text for translation.

DOM Tree Viewer

- The DOM Tree Viewer allows a developer to view the styles, attributes and elements of a web document.

  Selecting Tools Show DOM Tree opens a new window which displays the document object model (DOM) of the current HTML page.

  By default the display starts at the root node of the document, example: documentElement, all other nodes that you will see are children or descendants of the root node.

  If you wish to manipulate the DOM tree in any way you will have to use an external script to do so.

Web Page Validator

- This plugin uses the W3C HTML validator to validate the current page, very useful when creating web pages.

  Validate &HTML; (by URI) / Validate &HTML; (by Upload)

- The validate &HTML; option allows you to compare your &HTML; document to the defined syntax of &HTML; and reports any errors found. Validating your &HTML; will ensure that your pages display properly on all browsers.

Validate CSS (by URI)

- Allows you to validate your &CSS; style sheet that is embedded in an &HTML; or &XHTML; document. Having valid &CSS; is critical to ensuring that your web site maintains a consistent look regardless of the browser that is being used.

Validate Links

- Allows you to confirm that the links on your site contain no redirects or broken links. This tool recursively checks all links on a site.

Validate Page

- Validates the current page but does not show the result in another window or tab as the previous actions. Using this item enables the action View Validator Report to display a summary of the validation.

Configure Validator

- The configure validator item allows you to view the preset validators you can use to validate your &HTML; and &CSS;.

HTML Settings

- Select Tools HTML Settings to enable or disable a number of HTML settings without going through the Settings dialog.

  JavaScript

- Allows you to turn the use of JavaScript in &konqueror; on or off.

Java

- Allows you to turn the use of &Java; in &konqueror; on or off.

Cookies

- Allows you to turn the use of Cookies in &konqueror; on or off.

Plugins

- Allows you to turn the use of the &konqueror; plugins you have installed on or off.

Autoload Images

- Allows you to turn on or off the loading of images in web pages.

Enable Proxy

- Allows you to enable or disable the use of a proxy in the &konqueror; browser.

Enable Cache

- Allows you to enable or disable the use of cache in the &konqueror; browser.

Cache Policy

- The Cache Policy submenu provides you with a way to configure the how &konqueror; uses cache. The possible uses include:

  - Keep Cache in Sync

  - Use Cache if Possible

  - Offline Browsing Mode

User Agent Changer

- Select Tools Change Browser Identification to get a menu that allows you to change the User Agent string without going through the Settings dialog procedure.

  The plugin allows you to change the Browser and Operating System identification on a domain-by-domain basis. This is useful when browsing websites that limit access to those using a particular web browser.

  Default Identification

- The default User Agent header for &konqueror; is Mozilla/5.0(compatible;Konqueror/4.7)(KHTML/4.7, like Gecko). If you come across a site that refuses this browser access, change your User Agent to one of the options below.

Browser submenu

- The following menu items show a lot of popular browsers like Firefox, Internet Explorer, Netscape Navigator, Opera, Other, and Safari.

Apply To Entire Site

- This option allows you to specify that the defined User Agent applies across every page on the site you are visiting.

Configure

- Selecting Configure opens the settings dialog and allows you to fine tune the amount of information you wish to reveal about the browser and operating system being used.

Archive Web Page

- Invoked with Tools Archive Web Page, this tool creates an archive (`.war` ) file containing the web page being viewed including the images. Left click on the archive file name to view the saved page.

## File Manager Mode

Folder View Filter

- This is controlled by Tools View Filter and allows you to choose which types of item are displayed in a folder.

Image Gallery

- In File Manager mode, you can select Tools Create Image Gallery or use &Ctrl;I to create an HTML page with thumbnails of all the images in the current folder. By default the HTML page is called `images.html` and the thumbnails are put into a new `images` folder.

  When you start the Image Gallery plugin a dialog opens allowing you to adjust the way the gallery is created.

  ## Page Look

  The Look dialog is for adjusting the appearance of the gallery page.

- Look Dialog Screenshot Screenshot

  Page title

- The Page title option has a text input box for changing the title of the image gallery page.

Images per row

- The Images per row option has a slider and a spin box for adjusting the number of thumbnails that are in a single row in the gallery.

Show image file name

- The Show image file name check box allows you to turn on or off the use of the filenames below the gallery thumbnails.

Show image file size

- The Show image filesize check box allows you to turn on or off the use of the filesizes below the gallery thumbnails.

Show image dimensions

- The Show image dimensions check box allows you to turn on or off the use of the image dimensions in pixels below the gallery thumbnails.

Font name

- The Font name combo box provides you with a choice of which font to use in creating the gallery.

Font size

- The Font size spin box is for changing the size of the font you selected.

Foreground color

- The Foreground color option has a selector for choosing the foreground color of the gallery, this includes the text areas.

Background color

- The Background color option has a selector for choosing the background color of the gallery.

## Folders

The Folders dialog is used for choosing where to save the gallery. This dialog is also used to configure what folders are used.

- Folders Dialog Screenshot Screenshot

  Save to HTML file

- The Save to file selector decides where you want to save you image gallery html page.

Recurse subfolders

- The Recurse subfolders check box enables recursing of subdirectories. If the check box is enabled, a slider and spin box are enabled to select the recursion depth.

Copy original files

- The Copy original files check box creates an image folder storing copies of the original images used in the gallery.

Use comment file

- The use comment file check box enables a file selector to choose a comments file to use with your gallery. The comment file contains the subtitles for the images.

  The format of this file is:

      # this is a comment, lines starting with '#' are ignored
      FILENAME1:
      Description

      FILENAME2:
      Description

## Thumbnails

The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery.

- Thumbnails Dialog Screenshot Screenshot

  Image format for the thumbnails

- The image format combo box allows you to choose what format is used for the thumbnail images.

Thumbnail size

- The thumbnail size option provides a slider and spin box for adjusting the size of the thumbnails used in the gallery.

Set different color depth

- The set different color depth check box enables a combo box for selecting a different color depth for the thumbnails if you wish to use a color depth other than the depth used in the original image.

Search Bar

- Provides a text box for easy access to search engines like Google. Clicking on the icon on the left side of the search box opens a menu to select and enable different search engines and configure their Web Shortcuts.

Shell Command Plugin

- This plugin enables you to execute a shell command in the current folder and view the output in a separate window.