Class Image

java.lang.Object
org.apache.wiki.plugin.Image
All Implemented Interfaces:
Plugin

public class Image extends Object implements Plugin
Provides an image plugin for better control than is possible with a simple image inclusion.
Most parameters are equivalents of the html image attributes.

Parameters :

  • src - the source (a URL) of the image (required parameter)
  • align - the alignment of the image
  • height - the height of the image
  • width - the width of the image
  • alt - alternate text
  • caption - the caption for the image
  • link - the hyperlink for the image
  • target - the target (frame) to be used for opening the image
  • style - the style attribute of the image
  • class - the associated class for the image
  • border - the border for the image
  • title - the title for the image, can be presented as a tooltip to the user
Since:
2.1.4.
  • Field Details

  • Constructor Details

  • Method Details

    • getDisplayName

      public String getDisplayName(Locale locale)
      Description copied from interface: Plugin
      Provides the ability for a plugin to provide it's display name that is visible via the [{}] autocomplete/suggestion mechanism within the editor.Example: Calls My Custom plugin
      Specified by:
      getDisplayName in interface Plugin
      Returns:
      String
    • getSnipExample

      Description copied from interface: Plugin
      Provides the ability for a plugin to provide a suggestion or template for execution within a wiki page. Default returns just the FQCN of the plugin, which should enable it to fire off, however no parameters are provided in this case. Override it to provide example inputs to aid users with configuring your plugin. Example: com.company.Plugin inputParamter='test'
      Specified by:
      getSnipExample in interface Plugin
      Returns:
      String
    • execute

      public String execute(Context context, Map<String,String> params) throws PluginException
      This is the main entry point for any plugin. The parameters are parsed, and a special parameter called "_body" signifies the name of the plugin body, i.e. the part of the plugin that is not a parameter of the form "key=value". This has been separated using an empty line.

      Note that it is preferred that the plugin returns XHTML-compliant HTML (i.e. close all tags, use <br /> instead of <br>, etc.

      Specified by:
      execute in interface Plugin
      Parameters:
      context - The current WikiContext.
      params - A Map which contains key-value pairs. Any parameter that the user has specified on the wiki page will contain String-String parameters, but it is possible that at some future date, JSPWiki will give you other things that are not Strings.
      Returns:
      HTML, ready to be included into the rendered page.
      Throws:
      PluginException - In case anything goes wrong.