Plugins
EasyWebEditor is designed for supporting "plugins", e.g. external applications that can help you to edit images and texts.
Click here for a complete list of all available plugins.
Click here for the 3D Button Plugin trial: when the plugin is installed, select a text block, then use the "magic" button to transform the text in a button. Then you can choose another text and repeat the transform, or apply a new transform.
If you are a programmer, you can write your own plugin in VisualBasic, Delphi or C / C++.
The purpose of an "image" plugin is to input a graphic file (gif or jpg), to enhance it, and to output modifications to the same file.
The purpose of a "text" plugin is to input text parameters (caption, font, color, bgcolor, style, size), to enhance it, and to output the result to a graphic file (name is also given as parameter).
The "insert object" plugin should output an image file that will be inserted into the page (image name is given as parameter).
The following text contains the specifications for programmers wishing to build a plugin application (or want to adapt their apps to work as a plugin). A plugin is very easy to implement: parameters are passed through the command-line, no OLE-COM stuff.
Text Plugins
To install a text plugin you need to add registry keys such as these:
[HKEY_CURRENT_USER\Software\VV\Iper\PluginText]
[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\MyPluginText1]
"EffectName"="My plugin text 1"
"EffectPath"="c:\\tmp\\myplugin.exe"
"EffectPars"="/text"
[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\PlugText2]
"EffectName"="Text eff 2"
"EffectPath"="c:\\windows\\myapp.exe"
"EffectPars"="/runiniperpluginmode /e2"
HP/EWE/PK/EBW call the plugin’s exe with given parameters (EffectPars) on command line, plus these parameters:
/Icaption="Hello word!" /Ifont="Times new roman" /Isize=12
/Icolor=#aa0000 /Ibg=#ffffff /Ib=0 /Ii=0 c:\...\heretheresult.gif
(Note that parameter values are replaced with selected text block ones. In the caption, an eventual "" means ". b=0 no bold, i=0 no italic).
In short, your application should generate an image having as file name the one passed as parameter ( c:\...\heretheresult.gif ) by using the other parameters.
Please notice that the "EffectPars" parameter is optional, for example it can contain a switch that your application needs in order to recognize that is being called as a VisualVision plugin.
(1.2 only, 2003) In case your program could not return a GIF image, just return a BMP image, same path and name, just different extension.
Image plugins
To install an image plugin you need to add registry keys such as these:
[HKEY_CURRENT_USER\Software\VV\Iper\PluginImage]
[HKEY_CURRENT_USER\Software\VV\Iper\PluginImage\MyPluginImg1]
"EffectName"="My plugin image 1"
"EffectPath"="c:\\tmp\\myplugin.exe"
"EffectPars"="/img"
HP/EWE/PK/EBW calls the plugin’s exe with given parameters on command line, plus this parameter:
c:\thepath...\theNameOfTheImage.gif
Please notice that the "EffectPars" parameter is optional, for example it can contain a switch that your application needs in order to recognize that is being called as a VisualVision plugin.
(1.2 only, 2003) In case your program could not return a GIF image, just return a BMP image, same path and name, just different extension.
"Insert object" plugin (1.3 only, will be available on April 2003)
To install a "insert object" plugin you need to add registry keys such as these:
[HKEY_CURRENT_USER\Software\VV\Iper\PluginObj]
[HKEY_CURRENT_USER\Software\VV\Iper\PluginObj\MyPluginObj1]
"EffectName"="My plugin obj 1"
"EffectPath"="c:\\tmp\\myplugin.exe"
"EffectPars"="/obj"
[HKEY_CURRENT_USER\Software\VV\Iper\PluginObj\PlugText2]
"EffectName"="Effect 2"
"EffectPath"="c:\\windows\\myapp.exe"
"EffectPars"="/thisisjustasample /e2 /thiskeycanbeempty"
HP/EWE/PK/EBW call the plugin’s exe with given parameters (EffectPars) on command line, plus these parameters:
/Ifont="Times new roman" /Isize=12
/Icolor=#aa0000 /Ibg=#ffffff /Ib=0 /Ii=0 c:\...\heretheresult.gif
(Note that parameter values are replaced with current text ones. b=0 no bold, i=0 no italic).
In short, your application should generate an image having as file name the one passed as parameter ( c:\...\heretheresult.gif ). It might use the other parameters parameters or it might not.
In case your program could not return a GIF image, just return a BMP image, same path and name, just different extension.
Please notice that the "EffectPars" parameter is optional, for example it can contain a switch that your application needs in order to recognize that is being called as a VisualVision plugin.
Hints
A text plugin is very useful if you can select a portion of text on your web pages, apply an effect, and can then quickly repeat this process for all titles of the page. Say your software is tePRO.exe, then you can quickly implement that behavior in this way.
[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\TextEffectPRO]
"EffectName"="Text Effect PRO effects"
"EffectPath"="c:\\windows\\tePRO.exe"
"EffectPars"="/effects"
[HKEY_CURRENT_USER\Software\VV\Iper\PluginText\
TextEffectPROredo]
"EffectName"="Text Effect PRO repeat last effect"
"EffectPath"="c:\\windows\\tePRO.exe"
"EffectPars"="/redolasteffect"
The software tePRO.exe should store the last effect done for HP/EWE/PK/EBW (for example in the same reg key, maybe by using a string like "EffectLast"), and should retrieve it when called with “/redolasteffect” option.
Note that this hint also applies for “image effects”.
Test and debugging
You can use any of our programs to test plugins (e.g. EasyWebEditor): when reg keys are found, a "magic" button will show for text and another one for images: you can select a text block or an image and use the button.
