Lets logged-in user flag page content

FlagPages 1.0.0

Module for ProcessWire: lets logged-in users flag pages.

With this module, a logged in user can flag/unflag pages, on whose template the flag link (see below) has been placed. These flags serve as "personal bookmarks" and are not a site-wide sticky setting.

Example Screenshot

Usage


On the module's config page you can set the user roles allowed to flag pages.

On the markup side, FlagPages module consists of two parts: Rendering the link and rendering a list with your current bookmarks.

First of all, load the module via:

$flags = $modules->get("FlagPages");

Then, use the renderLink method and place the output in your template. By adding the link to all or just certain templates, you can control which templates can be flagged and which can't.

echo $flags->renderLink();

The default output will be "Add {Name} to flags", or "Remove {Name} from flags". You can override these labels with parameters. For example:

echo $flags->renderLink("Add %s to my bookmarks", "Remove %s from my bookmarks");

Rendering the flagged pages list

echo $flags->renderList();

This will output a simple unordered list with links to pages the currently logged-in user has set a flag to.

echo $flags->renderList("classname foo bar");

Optional: If you would like to apply HTML classes on the generated unordered list, supply them as a string to the function's parameter.

Outputting the flagged pages count of the logged in user

echo $flags->showFlagCount();

Returns the count of flagged pages.

Installation


  • Requirement: ProcessWire 3.x

Within module area in ProcessWire Backend

Click "New" and search for FlagPages class name.

Manually

  1. Download or git clone, rename the module folder to "FlagPages" and put it into your site/modules folder
  2. Go to modules overview page and click "Check for new modules"
  3. Install the module. The module will appear under "Flag" section.

Forum topic


https://processwire.com/talk/topic/7044-release-flagpages/

Changelog


1.0.0

  • Add PHP namespace to ensure compatibility with ProcessWire 3
  • Make classlist argument in renderList() method optional
  • Improve code comments
  • Make error output translatable

0.2.3

  • Fixing module version number to prevent octal interpretation
  • Removing double class based installation method description in readme
  • Fixing method output - returning instead of echo'ing

0.2.2

  • Add method to return flagged pages count
  • Add option to insert HTML class names as renderList's parameter

0.2.1

Using ASM select for chosing user roles with flagging permission

0.2.0

Added setting to limit flagging ability to certain user roles

0.1.1

Simplified renderList() param logic (thanks, teppo)

0.1.0

Add basic functionality

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Twitter updates

  • ProcessWire 3.0.187: This week we have some very useful new additions to both the core Repeater Fieldtype and the ProFields Repeater Matrix Fieldtype. This post covers all the details along with a couple of brief demonstration videos— More
    22 October 2021
  • ProcessWire 3.0.185 (dev) core updates, plus new Session Allow module— More
    17 September 2021
  • Three new ProcessWire Textformatter modules: Find/Replace, Markdown in Markup, and Emoji— More
    3 September 2021

Latest news

  • ProcessWire Weekly #389
    The 389th issue of ProcessWire Weekly we'll check out the latest core updates, introduce the Session Viewer module, and more. Read on!
    Weekly.pw / 23 October 2021
  • New Repeater and Repeater Matrix features
    This week we have some very useful new additions to both the core Repeater Fieldtype and the ProFields Repeater Matrix Fieldtype. This post covers all the details along with a couple of brief demonstration videos. 
    Blog / 22 October 2021
  • Subscribe to weekly ProcessWire news

“To Drupal, or to ProcessWire? The million dollar choice. We decided to make an early switch to PW. And in retrospect, ProcessWire was probably the best decision we made. Thanks are due to ProcessWire and the amazing system and set of modules that are in place.” —Unni Krishnan, Founder of PigtailPundits