3.0.0 Released

Simple Review 3.0.0 has been released (download). An upgrade is available for 2.2.4 users (download), please note that the new templates are not compatible with 2.2.4 templates (template upgrade guide).

What’s new in 3.0.0:

  • New. Review templates support the hReview microformat. You can test what your review will look like in Google search here (example).
  • New. Can sort reviews.
  • New. Can now select a specific category when creating a menu item.
  • New. Reviews can now be tagged.
  • New. Reviews now have meta keywords and descriptions.
  • New. Option to require comments to be approved before being published.
  • Fix. Place holder {Review:Date} now works (from 3.0.0 beta 1).
  • Fix. User reviews are now working and have a redesigned template (from 3.0.0 beta 1).
  • Fix. Pager and filter.
  • Fix. Bug where the user’s real name was always displayed instead of the user name.
  • Change. The review template file has been renamed from template.html to template.html.php (from 3.0.0 beta 1).
  • Change. Place holder {Review:AwardImageUrl} has been renamed to {Review:Award} (from 3.0.0 beta 1).
  • Change. Place holder {Review:ModifiedDate} has been renamed to {Review:DateModified} (from 3.0.0 beta 1).
  • Change. Template system has changed. Old templates are no longer compatible.
  • Change. Simple Tags have been renamed to Place Holders. The place holders have a new easier to remember format and provide additional features – the old format is still supported. They are no longer case sensitive.
  • Change. Editing content is now more consistent with Joomla. The layout is now simpler and provides things such as an image selector.
  • Change. Category & review titles are now called fields. Fields are now optional.
  • Change. Include jQuery locally by default and upgraded to 1.4.3.

3.0.0 Templates

Template in Simple Review 3.0.0 are not compatible with previous templates 2.2.4. Templates in 3.0.0 are not that much different from 2.2.4 and should not take too long to convert them.

New templates important folders/files:

Old templates important folders/files:

As an example we will convert our old review template into the new template format.
We will base our new template on the default one.

  1. Create a new folder:
  2. From the default template
    copy the following into www/components/com_simple_review/templates/example/:

    • index.html
    • css
    • images
    • js
    • review

    You should now have the following:

  3. Open:

    Delete everything inbetween: <!––review template start––> and <!––review template end––>

    Open your old template file

    Copy everything inbetween <!–– START EDITING––> and <!–– STOP EDITING––> and
    paste it into your new template (replace the deleted text in template.html.php).

  4. You can optionally update your old Simple Review tags with the new Place Holders.
    You can see a list of the new place holders on your place holder admin page:

    Example update:
    {sr_name} = {Review:Title}
    {sr_createdBy} = {Review:Author}
    {sr_createdDate} = {Review:Date}
    {sr_rating} = {Review:Rating}
    {sr_maxRating} = {Review:RatingMax}
    {sr_avgUserScore} = {Review:RatingUser}
    {sr_imageURL} = {Review:Image}
    {sr_title1} = {Review:Field:1}
    {sr_title2} = {Review:Field:2}
    {sr_scoreBox} = {Review:Rating:Box}

    <?php echo $vm->content;?> = {Review:Body}
    <?php echo $this->Widgets->Display(‘CommentForm’);?> = {Widget:CommentForm}
    <?php echo $this->Widgets->Display(‘CommentDisplay’);?> = {Widget:CommentDisplay}

    Once you have updated all your templates you can go to your Simple Review configuration and
    on the Place Holders tab change the mode from ‘Legacy’ to ‘Enabled’.

  5. Copy your images into:
  6. Add your CSS to:

    Note that css classes starting with ‘srTitle’ are now ‘srField’.

  7. If you want to convert other templates such as a category template then create a new folder:
    Then repeat steps 3 to 6. Note some templates such as category have had JavaScript or structural changes to fix bugs or add features, so apply step 3 carefully and only if needed.