WordPress.org
Get WordPress

Plugin Directory

Changeset 748902


Ignore:
Timestamp:
07/31/2013 07:38:38 PM (12 years ago)
Author:
shauno
Message:

read me update with NGG 2.x info

Location:
nextgen-gallery-voting
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • nextgen-gallery-voting/tags/2.6/readme.txt

    r748607 r748902  
    77Stable tag: 2.6
    88
    9 Adds the ability for users to vote and rate your NextGEN v1.x Galleries and Images. Simple options give you the ability to limit who can vote on what.
     9Adds the ability for users to vote and rate your NextGEN Images. Simple options give you the ability to limit who can vote on what.
    1010
    1111== Description ==
    12 **PLEASE NOTE: This plugin is intended for use with NextGEN Gallery version 1.x. It has not been tested on version 2**
    13 I will be testing and releasing a version compatibile with NGG v2 in due course.
    14 
    15 This plugin adds the ability for users to vote on NextGEN Galleries and Images.
     12**PLEASE NOTE:** This plugin was written for NextGEN Gallery 1.x, but recently NGG have released version 2.x.
     13I am working on bringing all the voting features up to date, but currently only the **Image** options work with NGG 2.x
    1614
    1715= Features =
    1816
    19 * Individually enable or disabled per gallery or image
     17* Individually enable or disabled per image
    2018* Choose if registered and logged in users can vote
    21 * Allow a user to vote as often as they want, or just once per gallery/image
     19* Allow a user to vote as often as they want, or just once per image
    2220* Show or hide the results from your users
    2321* Choose from 3 ratings types: 1-5 Stars, 1-10 Drop Down, or Like/Dislike
    … …  
    3028
    3129== Frequently Asked Questions ==
     30
     31= Important note about NextGEN Gallery version 2.x =
     32This plugin was written for NGG 1.x. The recent release of NGG 2.x has lead to the gallery voting functions not being applicable anymore.
     33I am working on an update to fix this in the future, but please be aware that they currently DO NOT WORK. You can ignore any reference to
     34the gallery options in the FAQ below
    3235
    3336= In a nutshell, what is this? =
    … …  
    3639current results.
    3740
    38 = How do I add the voting form? =
    39 For Galleries it's easy.  You just need to enable voting on the gallery, and the voting form will automatically be appended to the gallery.
    40 There is some basic styling, but the markup has got plenty of classes and ids that you should easily be able to hook into with your own stylesheets to make suit your site.
    41 
    4241= How do I make the voting form appear for images? =
    43 For images there's an extra step.  First you need to enable voing on the specific images you want.  Then you need to add a tag to the gallery template from NextGEN Gallery.  I'm going to use NextGEN version 1.9.6 to as the example, but it should be pretty much the same for all versions:
    44 Between line 38 and line 53 in `/nextgen-gallery/view/gallery.php` is the loop that shows each image in a specific gallery.  You need to add the following tag anywhere in that loop: `<?php echo nggv_imageVoteForm($image->pid); ?>`.
    45 That will output the vote form where you put it.  Personally I like to place it on a new line after the close `<a>` tag (new line created 45)
    46 Do not put inside the `<a>` tag that wraps the image in some of the templates, or the link will conflict with the voting process.
     42You need to add a small tag, `<?php echo nggv_imageVoteForm($image->pid); ?>`, to the gallery output template to get the voting showing in
     43the galllery.
     44
     45For NGG 1.x, you can find the gallery templates in the `/plugins/nextgen-gallery/view/` directory. For the default shortcode, `[nggallery id=x]`, you
     46add the tag to the `gallery.php` file. If you add the `template` attribute to your shortcode, you need to alter the appropriate template. eg:
     47If you use the `[nggallery id=x template="caption"]`, you need to add the tag to the `gallery-caption.php` template.
     48
     49For NGG version 2.x, you need to add the tag to the `/nextgen-gallery/products/photocrati_nextgen/modules/nextgen_basic_gallery/templates/thumbnails/index.php`
     50template. This will only work for galleries inserted WITHOUT selectiong a template from the gallery display options.
     51
     52Please be aware, the voting form needs to be placed inside the `foreach()` loop in those templates, as that loop is outputting each image.
     53I find the best place to put the tag is AFTER the `<div class="ngg-gallery-thumbnail">` is CLOSED.
    4754
    4855= Can I style it? =

  • nextgen-gallery-voting/trunk/readme.txt

    r748607 r748902  
    77Stable tag: 2.6
    88
    9 Adds the ability for users to vote and rate your NextGEN v1.x Galleries and Images. Simple options give you the ability to limit who can vote on what.
     9Adds the ability for users to vote and rate your NextGEN Images. Simple options give you the ability to limit who can vote on what.
    1010
    1111== Description ==
    12 **PLEASE NOTE: This plugin is intended for use with NextGEN Gallery version 1.x. It has not been tested on version 2**
    13 I will be testing and releasing a version compatibile with NGG v2 in due course.
    14 
    15 This plugin adds the ability for users to vote on NextGEN Galleries and Images.
     12**PLEASE NOTE:** This plugin was written for NextGEN Gallery 1.x, but recently NGG have released version 2.x.
     13I am working on bringing all the voting features up to date, but currently only the **Image** options work with NGG 2.x
    1614
    1715= Features =
    1816
    19 * Individually enable or disabled per gallery or image
     17* Individually enable or disabled per image
    2018* Choose if registered and logged in users can vote
    21 * Allow a user to vote as often as they want, or just once per gallery/image
     19* Allow a user to vote as often as they want, or just once per image
    2220* Show or hide the results from your users
    2321* Choose from 3 ratings types: 1-5 Stars, 1-10 Drop Down, or Like/Dislike
    … …  
    3028
    3129== Frequently Asked Questions ==
     30
     31= Important note about NextGEN Gallery version 2.x =
     32This plugin was written for NGG 1.x. The recent release of NGG 2.x has lead to the gallery voting functions not being applicable anymore.
     33I am working on an update to fix this in the future, but please be aware that they currently DO NOT WORK. You can ignore any reference to
     34the gallery options in the FAQ below
    3235
    3336= In a nutshell, what is this? =
    … …  
    3639current results.
    3740
    38 = How do I add the voting form? =
    39 For Galleries it's easy.  You just need to enable voting on the gallery, and the voting form will automatically be appended to the gallery.
    40 There is some basic styling, but the markup has got plenty of classes and ids that you should easily be able to hook into with your own stylesheets to make suit your site.
    41 
    4241= How do I make the voting form appear for images? =
    43 For images there's an extra step.  First you need to enable voing on the specific images you want.  Then you need to add a tag to the gallery template from NextGEN Gallery.  I'm going to use NextGEN version 1.9.6 to as the example, but it should be pretty much the same for all versions:
    44 Between line 38 and line 53 in `/nextgen-gallery/view/gallery.php` is the loop that shows each image in a specific gallery.  You need to add the following tag anywhere in that loop: `<?php echo nggv_imageVoteForm($image->pid); ?>`.
    45 That will output the vote form where you put it.  Personally I like to place it on a new line after the close `<a>` tag (new line created 45)
    46 Do not put inside the `<a>` tag that wraps the image in some of the templates, or the link will conflict with the voting process.
     42You need to add a small tag, `<?php echo nggv_imageVoteForm($image->pid); ?>`, to the gallery output template to get the voting showing in
     43the galllery.
     44
     45For NGG 1.x, you can find the gallery templates in the `/plugins/nextgen-gallery/view/` directory. For the default shortcode, `[nggallery id=x]`, you
     46add the tag to the `gallery.php` file. If you add the `template` attribute to your shortcode, you need to alter the appropriate template. eg:
     47If you use the `[nggallery id=x template="caption"]`, you need to add the tag to the `gallery-caption.php` template.
     48
     49For NGG version 2.x, you need to add the tag to the `/nextgen-gallery/products/photocrati_nextgen/modules/nextgen_basic_gallery/templates/thumbnails/index.php`
     50template. This will only work for galleries inserted WITHOUT selectiong a template from the gallery display options.
     51
     52Please be aware, the voting form needs to be placed inside the `foreach()` loop in those templates, as that loop is outputting each image.
     53I find the best place to put the tag is AFTER the `<div class="ngg-gallery-thumbnail">` is CLOSED.
    4754
    4855= Can I style it? =
Note: See TracChangeset for help on using the changeset viewer.