DataPluginImg

an overview of using images in bitweaver

Created by: mlpvolt, Last modification: 14 Aug 2006 (18:04 UTC)
One or more images can be inserted into any wiki page, blog entry, and news article in bitweaver.

Filetypes: Bitweaver supports most image file types thanks to it's use of either GD libraries, the ImageMagick or the magickwand estensions.

Images in news articles. When creating or editing a news article users can upload and resize an image which is displayed in the upper left corner of the article. No plugin is required for this use.

Images in blog posts and wiki pages In order to place images in wiki pages or blogs, you need to upload a picture first (via the images galleries) and then use the path to approriate gallery as the "src" (source) parameter plugin.

The image tag:
syntax: {img src= width= height= align= desc= link= }


To put an image into a page, you need to know its directory path. Once you are viewing (in the fisheye gallery) the image you want to place on a page, then right-click copy image location to copy the path. Then return to the page you would like to include the image into and use the image tag.

Image Plugin Parameters

using HTML The parameters used in the { img } plugin are the same as the parameters in the HTML "img" tag. Since the plugin syntax is the same as the html syntax, you may use the { and < brackets interchangably (if html is allowed).

Parameter
Values allowed
Description
Example
src URL The URL of the image to display
desc "text" Defines a short description of the image
align center, left, right Specifies how to align the image according to surrounding text.
height pixels or % Sets the height of the image 400
width pixels or % Sets the width of the image 600
link URL If you insert a link, clicking the image will take you to that location


using CSS if the img (html tag?) and the description are enclosed within <div> tags you can use various css parameters:
The following parameters take CSS style parameters

Parameter
Values allowed
Description
Example
float If you want to float the image. right
padding Padding around the image. 5px
margin Margin around the image. 5px
background Background colour around the image. #ff6600
border Defines a border around an image. 3px solid pink
text-align Will help you align the description with the image center
color Colour of the description that goes with the image #990000
font Font settings for the description
font-size Font size of the description 10px
font-weight Font weight of the description bold
font-family Font family for the description text Verdana, sans-serif


Uploading images to an image gallery.

Bitweaver uses the fisheye package to store and view image files. By default, each user has an image folder created for them, and a fixed amount of storage space. In Bitweaver all content is assigned a number as well as a name, and image galleries are no exception.

URL: http://yoursite.com/fisheye/upload.php

The fisheye upload screen, it is easy to upload multiple images, and store them in a file gallery for later use.

A list of all galleries is available at:
http://yoursite.com/fisheye/index.php

You can view any gallery directly by knowing the gallery ID number.
http://yoursite.com/fisheye/view.php?gallery_id=1

You can also link directly to an image (displayed by itself)
http://yoursite.com/fisheye/view_image.php?image_id=6&gallery_path=/1

Uploading images as attachment

As an alternate method, you can directly upload images to the server as wiki page attachments. Once it is attached, you can then use either the img plugin or the Attach plugin to display it. This will not place the image in a gallery and the image can only be viewed when included in a wiki page or article. Since the method requires the same amount of steps it is not a short cut.

Inserting an image as an attachment
An image file (or any other kind of file) and be attached to the page using the attachments tab in the edit screen. This can be used to upload a file instead of going to the fisheye/upload page, with an identical result.
1. Opening the attachments tab, upload the image as an attachment.
2. Save. The image will appear thumbnailed and right aligned on the page.
3. Right click on the image and copy image location.
4. Edit the page again and use the location in the src parameter of the img tag.
5. you can detach (but not delete) the attachment now if you like, the image will stay.

Once you have uploaded images / attachments, they will show up in the attachment browser in the wiki edit page. This gives you a list of all files you have uploaded and their attachment ids. this allows you to use the attachment plugin to insert the attachments in the page.

Bugs/Suggestions


It would be nice to incorporate an "upload attachment (to gallery) option in the edit template.

It is preferable to have images align left and have text wrap around it as the default behavior.


Related Items

Documentation » Plugins

Documentation relating to Liberty and Wiki plugins

  •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •  

Online Help

These pages are linked from within bitweaver's administration

  •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •    •  Anonymous  •  Anonymous  •  Anonymous  •  Array  •  Array

Comments

deleting an unlinked image

by , 15 Jan 2007 (09:53 UTC)
Is it possible to delete an image that has been unlinked? Can this be done with the bitweaver interface?