History of DataPluginImg

Differences from version 3 to 9



@@ -1,22 +1,54 @@

+{maketoc}
 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.
+__Filetypes:__ Bitweaver supports most image file types thanks to it's use of either ((GD libraries)), the ((imagemagick)) or the ((magickwand)) estensions.
 
-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).
+__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.
 
-!!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.
+__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.
 
-__URL:__ http://yoursite.com/fisheye/upload.php
+^__The image tag:__
+syntax: ~np~ {img src= width= height= align= desc= link= } ~/np~^
 
-The fisheye upload screen, it is easy to upload multiple images (one after the other), and store them in a file gallery fo later use.
+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 Galleries
+!!Image Plugin Parameters
+__using HTML__ The ((parameter))s used in the ~np~{ img }~/np~ 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 ~np~ { and < ~/np~brackets interchangably (if html is allowed).
 
-In Bitweaver all content is assigned a number as well as a name, and image gallaries are no exception.
+|| __::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 ~np~ <div> ~/np~ 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 ((FisheyePackage|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://highproductivity.ca/fisheye/index.php
+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

@@ -24,14 +56,23 @@

 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.
+!!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 ((DataPluginAttachment|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.
 
-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.
+__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 ((DataPluginAttachment|attachment plugin)) to insert the attachments in the page.
 
-__The image tag:__
-syntax: ~np~ {img src= width= height= align= desc= link= } ~/np~
+!!Bugs/Suggestions
 
-__Note:__ The ((parameter))s used in this tag are the same as the parameters in the HTML "img" tag. You can pretty much swap the ~np~ { and < ~/np~brackets interchangably, if you are allowing bitweaver to parse html.
+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.
 
 
Page History
Date/CommentUserIPVersion
14 Aug 2006 (18:04 UTC)
refactoring important stuff to the top
mlpvolt206.248.158.369
Current • Source
xing194.152.164.458
View • Compare • Difference • Source
mlpvolt206.248.132.1097
View • Compare • Difference • Source
mlpvolt206.248.132.1094
View • Compare • Difference • Source
mlpvolt206.248.132.1093
View • Compare • Difference • Source
mlpvolt206.248.132.1092
View • Compare • Difference • Source
mlpvolt206.248.132.1091
View • Compare • Difference • Source