Sourcefabric Manuals

 English |  Español |  Français |  Italiano |  Português |  Русский |  Shqip

TagesWoche Newscoop 4.4 Implementation

Featured Comments

 Featured Comments plugin gives you ability to highlight your favourite comments in Newscoop. You will be able to make for e.g. TOP 5 comments all over the site.

While using this plugin you will be able to create different lists of comments (as we have so far, list of featured articles), manage and display them in theme anywhere you want.


  • Filtering by:
     - publications,
     - issues,
     - sections,
     - articles
     Extra filters
     - author
     - create date
     - language
  • Managing
     - drag and drop comments to create custom lists
     - saving lists
     - removing lists
     - adding new lists
     - removing single comments from lists

  • Searching
     - comment search by name, email, subject, comment message, article title
  • Editing existing comments without changing original one
  • Adding external comment, e.g. from Facebook, Twitter etc.


More about plugin

  • Searching
    To find comment you wish you have to type name, email, subject, comment message, article title in "Search"


  • Managing lists
    If the list name is not given, then the default comment list will be set to: 'CommentList-<current_date> e.g: CommentList-2013-10-24 23:35:41.
    If the comment is already in featured list, proper error message will show up


  • Filters
    'Reset all filters' option will reset all extra filters (Commenter, Date created, Language)


Smarty block

       To display featured comments lists in fronted, use below code and place it in whichever template file you wish. Let's say for e.g. front.tpl

{{ list_featured_comments }} 
	{{ $gimme->featured_comment->message }} <br>
{{ /list_featured_comments }}


Above code will display all comments from all lists (defined by administrator in Featured Comments plugin backend). Look at Screen 1.

Screen 1. Comments view in frontend.

You have ability to define some constraints to display lists by given criterias.

List criterias:

  • id - list id
  • name - list name
  • orderBy - order (default is set to list create time)

Define constraints:

For e.g. to define constraints to display list with id = 1 or/and name "testlist" we can do something like this:

{{ list_featured_comments constraints="id is 1 name is testlist" }} 
	{{ $gimme->featured_comment->message }} <br>
{{ /list_featured_comments }}

Above example will show us comments for list with id = 1 and name testlist.

If you do not use constraints, the comments from all defined lists are displayed.


Featured comment Meta class (access from template to featured comment added to list)

To have ability to manage featured comments in templates, meta class is given with properties:

editedMessage Comment edited message
editedSubject Comment edited subject
subject Original comment subject
message Original comment message
identifier Comment id
nickname Commenter full name
email Commenter email

Commenter url (especially defined when

added as exteranl comment, e.g. from Facebook)

anonymous_author Checks if commenter is anonymous
submit_date Comment creation date
article MetaArticle - Article which comment was submitted
user MetaUser - Registered user properties if not anonymous
source Comment source (e.g. Facebook, Twitter etc.)
isEdited Checks if comment was edited by editor

Example usage:

{{ list_featured_comments constraints="id is 1 name is testlist" }} 
	{{ $gimme->featured_comment->editedMessage }} <br>
	{{ $gimme->featured_comment->nickname }} <br>
 {{ /list_featured_comments }}

Adding external comments:

You can easly add external comment (e.g. from Facebook or Twitter). The big button "Add External Commet" (look at Screen 6.) gives you that possibility to do that.

After clicking on that button, modal window will show up with options to add a new external comment. Look at screen below:

Screen 2. Adding external comment

There is also possibility to choose to which article this comment will be submited. When submitted, it will show up under that article in frontend and in backend. In plugin backend near that comment, label with source name will show up, similar one to "Edited" label (Screen 3.)


Editing featured comments

When you drag and drop comment to created list or when you load one of the existings lists, you will be able to edit comment. After mouse move on comment in Featured Comment list (right side), "Quick edit" button will show up:

Screen 3. Quick edit button

After clicking on "Quick edit" button, option to edit original comment will show up:

Screen 4. Editing original comment

When submitted, comment will be saved and will show up on frontend smarty block edited version of comment, not the original one. In plugin backend edited comment will have label "Edited" (look at Screen 6.)


Comment hook:

To easly add comment to comment list, plugin hook has been implemented. It let's editor to quickly add comment to selected list. (e.g. Good comments, Bad comments etc.).

Hook will show up in Content -> Comments near comment action buttons:

By clicking on "x" near list name, comment will be removed from currently selected list.


Comments order in lists:

To quickly change the order of the comments list that is displayed in frontend, change the order of the comments on the selected list (in backed, look at screen below) and save the current state.

Screen 5. Featured Comments Backend - comments ordering

In "Available Comments" column (look at Screen 6.) by default 15 comments per page are displayed, sorted descending (last added comments will be on top of the list).




Screen 6. Backend view

There has been error in communication with Booktype server. Not sure right now where is the problem.

You should refresh this page.