|
If you are using xoblite:
To load BBDropFTP, you simply need to select Load plugin... in the Configuration/Plugins menu
(this item is also available in the Slit menu), locate BBDropFTP.dll, and click "Open". Simple, eh? :)
If you are using Blackbox for Windows:
To load BBDropFTP you need to add the relative path of the plugin (from your Blackbox directory) to the Blackbox configuration file plugins.rc (located in the Blackbox directory).
For example, if you installed Blackbox into c:\Blackbox, and BBDropFTP.dll is located in c:\Blackbox\plugins\BBDropFTP, you should add the line...
plugins\BBDropFTP\BBDropFTP.dll
...to plugins.rc.
All configuration is performed using the right-click plugin menu (it should be pretty self-explanatory what each menu
item does). Second, you can mid click on the window to select the next target, or use the mousewheel to scroll up/down in your list
of targets. Third, you can doubleclick on the BBDropFTP window to open a file requester which will let you
select a file to upload to the currently selected target (please note that you can only upload
one file at a time to the target!). And finally, you can X click the window to dock to / undock from the slit.
I have included a default FTP upload targets configuration file - bbdropftp.ini - in the .zip, but if a configuration file for some reason (e.g. you deleted it! <g>)
can not be found at startup (BBDropFTP will first search for it in the UserAppData/Blackbox directory, then in the same directory as the plugin, then in the Blackbox directory),
BBDropFTP will automatically create one for you in the same directory as the plugin.
BBDropFTP lets you define a virtually unlimited number of FTP upload "targets" (a folder on an FTP server), which are defined as follows:
*Target alias server port username password remotedirectory [url]
...where the "url" parameter is optional (hence the [] brackets above, they should not be included in the configuration file if you define this parameter), but please note that the copy URL to clipboard functionality (see below) will only work if this parameter is defined. The default bbdropftp.ini file contains an example target to clarify the syntax (here the line is wrapped due to its length, but it should be a single line in your bbdropftp.ini file):
*Target example ftp.example.com 21 username password /username/web http://username.example.com/
Please note that BBDropFTP will automatically use the proxy defined under "Internet Options" in the Control Panel. So, bottom line, you create a target for every FTP server/folder you need to access frequently (and maybe not so frequently, your call! <g>).
These targets will be listed in the BBDropFTP plugin menu, and you can then select a target and upload a file to the target using either mouse/menu
commands or using bro@ms (see below)! :D
I have included a default configuration file - bbdropftp.rc - in the .zip, but if a configuration file for some reason (see above!)
can not be found at startup (BBDropFTP will first search for it in the UserAppData/Blackbox directory, then in the same directory as the plugin, then in the Blackbox directory),
BBDropFTP will automatically create one for you in the same directory as the plugin. Normally, you do not need to edit this file manually - use the right-click plugin menu instead!
bbdropftp.x: 0 X position
bbdropftp.y: 0 Y position
bbdropftp.alwaysontop: false AlwaysOnTop?
bbdropftp.snapwindow: true Snap BBDropFTP window to screen edges?
bbdropftp.transparency.alpha: 255 Alpha transparency value (value 1-255; 255 being opaque)
bbdropftp.dockedtoslit: false Docked to the slit? (ie. slit mode if true, plugin mode if false)
bbdropftp.copytoclipboard: false Copy URL to clipboard when the file has been uploaded?
bbdropftp.showdetails: false Show details on successful uploads?
bbdropftp.selected: example Alias of the currently selected FTP upload target
Finally, you can control BBDropFTP using the following broadcast messages (bro@ms)...
@BBDropFTP UploadFile <file>
@BBDropFTP ChangeTarget <target>
@BBDropFTP EditTargets
@BBDropFTP ToggleCopyToClipboard
@BBDropFTP ToggleShowDetails
@BBDropFTP ToggleAlwaysOnTop
@BBDropFTP ToggleSnapWindowToEdge
@BBDropFTP ToggleDockedToSlit
@BBDropFTP SetTransparency <alpha>
@BBDropFTP GoToURL
...which are equivalent to the items in the BBDropFTP plugin menu. Hmm, I guess that's it! :D
|