|
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 (except for setting the alpha transparency value, see below) 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
The default bbdropftp.ini file contains an example target to clarify the syntax:
*Target example ftp.example.com 21 username password /username/temp
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,
however you may want to tweak the alpha transparency value (see below) to your liking.
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: false Enable transparency?
bbdropftp.transparency.alpha: 60 Alpha transparency value
bbdropftp.dockedtoslit: false Docked to the slit? (ie. slit mode if true, plugin mode if false)
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 ToggleDockedToSlit
@BBDropFTP ToggleAlwaysOnTop
@BBDropFTP ToggleSnapWindowToEdge
@BBDropFTP ToggleTransparency
@BBDropFTP EditTargets
...which are equivalent to the items in the BBDropFTP plugin menu. Hmm, I guess that's it! :D
|