History of DataPluginImg

One or more images can be inserted into any wiki page, blog entry, and news article in bitweaver.

Filetypes: Bitweaver supports jpeg, gif and png.

When creating a news article you are promted to upload and resize an image. For blog posts and wiki pages, the process is slightly more complicated - you need to upload a picture to the image galleries first and then link to it on the page using the wiki syntax (image tag).

To upload images:

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.

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

The fisheye upload screen, it is easy to upload multiple images (one after the other), and store them in a file gallery for later use.

Image Galleries

In Bitweaver all content is assigned a number as well as a name, and image gallaries are no exception.

A list of all galleries is available at:
http://highproductivity.ca/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

Inserting an image in a page.

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.

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

Note: The parameters used in this tag are the same as the parameters in the HTML "img" tag. You can pretty much swap the { and < brackets interchangably, if you are allowing bitweaver to parse html.

When using { img} the image and the description are enclosed with a "div" tag, that you can style with various css parameters:

• border
• padding
• width
• float
• color
• background
• border
• text-align

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.

Img tag parameters and usage

Note: The "align", "border", "hspace", and "vspace" attributes of the image element were deprecated in HTML 4.01, but can still be used fairly reliably if you don't want (or don't know how) to use/modify styles in the CSS.

Parameter	Values allowed	Description
src	URL	The URL of the image to display
alt	"text"	Defines a short description of the image
align	top, bottom, middle, left, right	Specifies how to align the image according to surrounding text. (Deprecated. Use styles instead)
border	pixels	Defines a border around an image. (Deprecated. Use styles instead)
height	pixels or %	Defines the height of an image
width	pixels or %	Sets the width of an image
hspace	pixels	Defines white space on the left and right side of the image. (Deprecated. Use styles instead)
vspace	pixels	Defines white space on the top and bottom of the image. (Deprecated. Use styles instead)
longdesc		URL	URL to a document that contains a long description of the image

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.



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.