BBDropFTP 1.2
description
BBDropFTP is a xoblite / Blackbox for Windows plugin that lets you upload files to a virtually unlimited number of pre-defined FTP upload "targets" through a simple drag'n'drop to its window, using a file requester, or by sending it a single bro@m (which can of course be mapped to e.g. a hotkey). Want to upload your latest wallpaper, style or plugin to make it available to others? ...your creation is now just a drag'n'drop or less away from the Internet! =]

Please note that BBDropFTP 1.2 requires xoblite bb2 RC3
or later / Blackbox for Windows 0.0.90 or later.

Enjoy! :D

Today is yesterday's tomorrow.

qwilk

revision history
BBDropFTP 1.2 (2005-10-23) / qwilk
  • Added an optional "URL" parameter to the target definition, which is the URL to the directory corresponding to the FTP upload directory (i.e. this directory URL + the filename becomes the full URL of the uploaded file) -> suggested by Juzzy - thanks!
  • Added the possibility to copy the URL of the uploaded file to the clipboard (configurable) and a bro@m to open the URL in your preferred web browser:
    @BBDropFTP GoToURL
  • Added the possibility to show details for successful uploads (configurable)
  • Got rid of the old transparency toggle + alpha configuration menu items in favour of a single transparency alpha editing item (value 1-255; 255 being opaque)
  • BBDropFTP 1.0.1 (2004-11-07) / qwilk

  • Now deleting an existing remote file before uploading the new one (some FTP servers do not seem to handle new file size == old file size)
  • A file will now only be uploaded if the remote working directory can be set
  • BBDropFTP 1.0 (2004-03-28) / qwilk

  • Original release
  • future releases?
  • [your wish goes here - send me your ideas! :D ]
  • license information
    © 2004-2005 Karl-Henrik Henriksson [qwilk]

    BBDROPFTP IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. THE AUTHOR DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL THE AUTHOR OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF THE AUTHOR OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

    initial setup

    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.

    how to use bbdropftp...

    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.

    bbdropftp.ini settings

    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

    bbdropftp.rc settings

    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