NP_gallery/tags/v0.95/gallery/Install notes.txt

   1 NP_gallery\r
   2 johnkbradshaw@yahoo.com\r
   3 \r
   4 See bottom for version history.\r
   5 Current release is 0.77 (5-4-05)\r
   6 \r
   7 To Upgrade:\r
   8  -- To upgrade from 0.61, run np_gallery_update061.php in your base nucleus directory\r
   9  -- To upgrade from 0.75, run np_gallery_update075.php\r
  10  -- Delete both np_gallery_update files\r
  11 \r
  12 To install:\r
  13 1. make a skin called NPGallery with a call to <%gallery%> in it. For example mine looks like this:\r
  14         <%ExtraSkin(header2)%>\r
  15         <div id="contents">\r
  16            <%gallery%>\r
  17         </div>\r
  18         <%ExtraSkin(menu2)%>\r
  19         <%ExtraSkin(footer2)%>\r
  20 \r
  21 2. Create a link to the gallery in another skin with the skinvar <%gallery(link)%>, i.e. with this code: <a href="<%gallery(link)%>">Gallery</a>.\r
  22 \r
  23 3. upload the files in the zip to your webserver into the base directory (add_picture.php should be in the same directory as your index.php)\r
  24 \r
  25 4. create the folder media/gallery and make it writable (chmod 0777 or 0755)\r
  26 \r
  27 5. add the following to your CSS file:\r
  28                 #NPG_gallery {\r
  29                         margin-top: 5px;\r
  30                         margin-bottom: 5px;\r
  31                         padding-left: 5px;\r
  32                         padding-right: 5px;\r
  33                         position:relative;\r
  34                 }\r
  35 \r
  36                 /*thumbnails are displayed as a 'list'*/\r
  37                 ul.thumbnail {list-style: none;}\r
  38                 \r
  39                 ul.thumbnail li {\r
  40                         float: left; \r
  41                         width: 115px; \r
  42                         height: 140px;\r
  43                         padding: 10px;\r
  44                         margin: 10px;\r
  45                         background-color: rgb(225,225,225);\r
  46                 } \r
  47         \r
  48                 /*thumbnail container*/\r
  49                 #NPG_thumbnail {\r
  50                         margin-top: 5px;\r
  51                         margin-bottom: 5px;\r
  52                         padding-left: 5px;\r
  53                         padding-right: 5px;\r
  54                         position:relative;\r
  55                 }\r
  56                 /*footer container -- used so that the footer contents are actually displayed below the thumbnails, without clear:both the footer is displayed under the thumbnails*/\r
  57                 #NPG_footer {\r
  58                         clear:both;\r
  59                 }\r
  60 \r
  61  \r
  62 6. install the plugin\r
  63 \r
  64 7. play around with it and let me know what you think.\r
  65 \r
  66 version history:\r
  67 --NP_gallery v0.4 alpha 3-8-2005: first alpha release\r
  68 --NP_gallery v0.45 alpha 3-9-2005:\r
  69         fixed bugs with permission system\r
  70         changed the way albums are modified (moved to admin area)\r
  71         added preliminary album team support\r
  72         other bug fixes\r
  73 --NP_gallery v0.5 alpha 3-9-2005:\r
  74         album teams (in admin area)\r
  75         delete album (in admin area)\r
  76         delete picture\r
  77         can now select add album permission level\r
  78         next, previous nav links on picture view\r
  79         move picture to different album\r
  80         bug fixes\r
  81 --NP_gallery v0.55 alpha 3-17-2005:\r
  82         changed the default media directory style -- used to be something like ./foo/, now it is just foo/\r
  83         (previous change will mean that you should uninstall the plugin and delete the pictures in your gallery folder and reinstall them)\r
  84         thumbnail size can be changed\r
  85         rethumb (which resizes the thumbnails and intermediate pictures) function in admin area\r
  86         some bug fixes to address base_redirect\r
  87 --NP_gallery v0.56 alpha 3-19-2005:\r
  88         fixed so that the plugin will work with 3.2\r
  89         couple other bug fixes\r
  90 --NP_gallery v0.6 alpha 3-21-2005:\r
  91         new feature: promote to blog\r
  92                 please configure this option in the admin area before using\r
  93                 I need to do cosmetic cleanup for the forms and the post, but wanted to try out the concept\r
  94         bug fixes to re-thumb admin function\r
  95 --NP_gallery v0.61 alpha 3-22-2005\r
  96         *changes made in this release require uninstall/reinstall       \r
  97         added title template var -- displays title under thumbnail by default\r
  98         updated default css class: ul.thumbnail li (see above for change)\r
  99         fixed message after adding promo post\r
 100         fixed sql error when adding pictures\r
 101         when deleting a picture, there is an option to delete promo post associated with the picture\r
 102         number of picture upload slots is now an option in the admin area\r
 103         removed reference to a file in album_class.php that was triggering open_basedir problems\r
 104         added allowable tag to item body: <%gallery(link,picture|album,#)%>\r
 105         added cancel promo post\r
 106         promo post now uses bookmarklet.php edititem form\r
 107         fixed another bug with the rethumb function -- now works (on my system) with gd or imagemagick\r
 108 --NP_gallery v0.75 4-6-2005\r
 109         moved to a class to handle admin page (like nucleus)\r
 110         started the move to allowing for translation to other languages (see english.php)\r
 111         added album template vars: centeredtopmargin(height, offset) and pictureviews\r
 112                 centeredtopmargin inserts a margin-top that will vertically align a thumbnail using inline css (ie <img style="<%centeredtopmargin(140,-7)%>" src= ...)\r
 113                 pictureviews displays the number of time a picture has been viewed\r
 114         comment system\r
 115         multiple templates\r
 116 --NP_gallery v0.76 4-12-2005\r
 117         comment system works with np_captcha plugin\r
 118         new templatevars: \r
 119                 <%albumdescription%> and <%picturedescription%> in album view\r
 120                 <%if(next)%>, <%if(prev)%>, <%description%> in picture view\r
 121                 <%if(commentsallowed)%> in picture view\r
 122                 <%albumthumbnail%> in gallery list view\r
 123         album option for thumbnail\r
 124         album option for comments allowed or not\r
 125         plugin hooks: NPgPrePicture, NPgPostAddPicture, NPgPostUpdatePicture, NPgPostDeletePicture, NPgAddPictureFormExtras, NPgEditPictureFormExtras\r
 126         new default templates\r
 127         pictures are now prefixed by a random string\r
 128 --NP_gallery v0.77 5-4-2005\r
 129         plugin hooks: NPgCollectionDisplay\r
 130         included NP_GalleryMostViewed\r
 131         bug fixes: \r
 132                 problems with templates\r
 133         absolute filenames for pictures and links\r
 134         modified <%breadcrumb%> tag to have an option for a different separator: <%breadcrumb(separator)%>, default is >\r
 135         the word 'Gallery' as part of the breadcrumb is now defined in english.php