Simple:Press Documentation

Plugin: Post Anonymously

Plugin Description

Plugin: Post Anonymously – This Simple:Press plugin allows forum users to post anonymously.

Plugin Features

Installing this Simple:Press plugin adds:

  • A new “Post Anonymously” section in the “Available Plugins – Install Simple:Press Plugins” panel under the forum Admin menu path Forum > Plugins > Available Plugins. From this panel the Simple:Press plugin can be activated or deleted by the admin.
  • When properly installed, a new folder in the forum plugin folder named “anonymous” containing this plugin’s files.

Activating this plugin provides:

  • A change to the new “Post Anonymously” section in the “Available Plugins – Install Simple:Press Plugins” panel under the Admin menu path Forum > Plugins > Available Plugins so the plugin can be deactivated, or uninstalled.
    • There are no administrative options associated with this plugin.
    • The “Getting Started” link should be selected to view the pertinent information regarding the plugin.
  • For forum users with the “Can post anonymously” permission:
    • In the topic creation template a new “Make this post anonymous” check box in the “Options” section that the topic creator can select by clicking on to make the post anonymous. The check box is selected when it contains a green check mark.
    • In the topic reply template a new “Make this post anonymous” check box in the “Options” section that the reply post creator can select by clicking on to make the reply post anonymous. The check box is selected when it contains a green check mark.
  • In the Group View, Forum View, List View, etc., a post created as anonymous and meeting the display criteria (last post, first post, etc.) will have:
    • The name for the post’s author show up as “Anonymous”.
  • In the Topic View a post created as anonymous will have:
    • The avatar for the post’s author show up as “Guest”.
    • The name for the post’s author show up as “Anonymous”.
    • The usergroup for the post’s author show up as “Guest”.
  • A new profile option “Use anonymous posting for all posts” on the “Edit Posting Options” sub-tab under the “Options” tab of a user’s profile when the logged-in user clicks on the “Profile” button in the forum page header.
    • All posts made by the user while the option is in effect are posted anonymously (the “Make this post anonymous” check box is pre-selected in the post creation form [create topic or topic reply] for that user).
  • A new permission “Can post anonymously” that must be enabled by the forum Admin in the permission sets for usergroups being allowed to post anonymously.
    • A permission set is edited from the forum Admin menu at Forum > Permissions > Manage Permission Sets by clicking on the “Edit Permission” button associated with the permission set.

Plugin Requirements

Simple:Press version 5.5.4 and above is required.

The Simple:Press plugin must be installed and activated before it is operational.

  • As part of the installation, a “Post Anonymously” section is added to the “Available Plugins – Install Simple:Press Plugins” panel under the admin menu Forum > Plugins > Available Plugins. From this panel the plugin can be activated, deactivated, uninstalled or deleted using its “Activate/Delete” and “Deactivate/Uninstall” selections.
    • There are no options associated with this plugin.

There is one (1) new permission added to the permission sets due to this plugin that must be set up.

The plugin has no (0) template tags so there are no recommendations made regarding developing Child Themes or Custom Themes to accommodate changes to template tags.

Plugin Installation and Activation

Please see Using Plugins on how to obtain and install this Simple:Press plugin.

  • Whatever method is used to add the Simple:Press plugin, the folder that should have been added to the forum plugin folder is named “anonymous“.
  • If using the “Simple:Press Upload Plugin – Upload a Simple:Press Plugin” panel at the forum Admin menu Forum > Plugins > Plugin Uploader, the folder to browse for after downloading it from the Simple:Press site is “anonymous.zip” before clicking the “Upload Now” button.

As mentioned there the default location for Simple:Press plugin folders is …/wp-content/sp-resources/forum-plugins. If this path is changed, it is important to note that the plugin’s folder and its content need to reside in the forum plugins folder wherever it has been moved and however it has been renamed. See Storage Locations for more information.

Activation is accomplished from the Admin Dashboard panel menu by selecting Forum > Plugins > Available Plugins from the drop down forum Admin menu. On the “Available Plugins – Install Simple:Press Plugins” panel select the “Post Anonymously” plugin and click on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall” with a “Get Started” Link.

  • The “Getting Started” link should be selected to view the pertinent information regarding the plugin.

To deactivate the plugin, click on “Deactivate”. The “Deactivate/Uninstall” label changes to “Activate/Delete”.

Plugin Administrative Options

There are no administrative options to set and no “Options” link for this plugin.

From the Forum Admin menu on the left of admin pages, select Forum > Permissions > Manage Permission Sets to see the permission sets available.

  • Assigning New Permissions
    • Can post anonymously permission
    • Allowing users to post anonymously is controlled by their group permissions.
    • Each member group that is to have that ability must have the permission turned on.
    • This is accomplished from the Simple:Press Administration panel Admin menu by clicking/opening Forum > Permissions > Manage Permission Sets.
    • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
    • Under “Viewing” click the check box next to “Can post anonymously” to set/enable the permission. When enabled, the check box contains a green check mark.
    • Click “Update Permission” at the bottom of the page to have the selection saved.
    • At a later time clicking the check box when it has a green check mark removes the check mark and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
    • Repeat these steps on each usergroup to have this permission.

To be complete for multilingual forums, the language translation files for this plugin should be installed or downloaded/properly placed in the appropriate forum-language folder for SP plugins using one of the procedures below in the “Plugin Language Translation” section of this page.

Plugin Language Translation

A plugin may not have language translation files, but in general each Simple:Press plugin has its own language translation files each with multiple pages for translating the forum plugin’s message strings.

Forum Plugin translation files are to reside in a unique forum folder location as defined by the “Simple:Press Plugin Language Files” entry on the “Integration – Storage Locations” forum Admin panel available through the forum Admin menu at Forum > Integration > Storage Locations.

  • The default location for forum plugin translation files is the folder “…/wp-content/sp-resources/forum-language/sp-plugins”.

Information regarding downloading language files, “mo’ language file placement, and translation (language localization) is found at Localization.

WARNING: On the Localization page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.

More information is available regarding translation files at Simple:Press Translations. which is the repository for Simple:Press language translation files. On the base page, select the “Getting Started Guide” link for basics about it’s use. On that page, select the “register a username here” link to obtain a password to the site. Use the “Contact Form” link to request the desired language if it is not currently available. The “Contact Form” link may also be used to volunteer to be a validator for a translation project.

This plugin’s available language translation files with translation statistics, and message translations can be viewed at Post Anonymously within the repository for Simple:Press language translation files.

  • Installing this Simple:Press Plugin’s Language Translation “.mo” files
    The plugin’s language translations files for each language can be correctly located in two ways.

    • Using the Admin Word:Press “Site Language” and Simple:Press “Language Translation” Features
      WARNING: On the Localization codex page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.
        • Under the “Language Translation Selection Sequences” heading, the “Coordinated Language Translation File Download Using the Simple:Press ‘Language Translation’ Selection” section, follow the instructions at “Adding its Translation File(s) After Downloading/Activating a Simple:Press Theme or Simple:Press Plugin”.
          • Follow the instructions to select the “Site Language” and then get to the admin page with the “Integration – Language Translations” section where there should be an entry for “Post Anonymously” along with an “Install” button.
          • Click on the “Install” button for this plugin to install the language translation file for the current “Site Language” language.
            • Note: If the message “No Translation Project Exists” is displayed rather than the “Install” button, a translation file for that language could not be found in GlotPress at this time. Consider posting in the Simple:Press forum if it is felt there needs to be one added.
          • Be sure to verify the locale (filename) for the “.mo” file matches the language code for the language as referenced in the “Warning” above. If it does not, change it to match.
          • As called out in the section, continue to change the “Site Language” language and repeat the process until all desired translation files for this plugin have been installed.

       

    • Manually Finding and Storing Simple:Press Plugin’s Language Translation ‘mo’ files
    • WARNING: On the Localization codex page, the Language Translation “.mo” Files Overview should be reviewed and well understood for naming convention and language translation file placement.
    • After reviewing the material discussed under the “Language Translation Selection Sequences” heading, the “Manual Installation of Simple:Press Language Translation Files section, follow the steps outlined at “Finding and Storing ANY Simple:Press Plugin’s Language Translation ‘mo’ files”.
    • Each time through the process at the step, “Scroll down the list and click on the name of the plugin whose language files are being sought to see the translation file Version Number available”, substitute “Post Anonymously” for the phrase “the name of the plugin whose language files are being sought”.
    • Be sure to verify the locale (filename) for the “.mo” file matches the language code for the language as referenced in the “Warning” above. If it does not, change it to match.
    • Repeat the steps for each language it is desired to have a translation file (french, spanish, etc.) for the plugin on the website.

Plugin Usage

Forum Users with proper permission may post anonymously when creating a new Topic post or replying in a Topic.

    • Posting Anonymously When Creating a New Topic Post
    • After installation and activation of the plugin, the post input form displayed to users with permission when entering a new topic has an additional input field where the originator may designate the original post in the topic be displayed anonymously (the poster not identified).
    • In the forum view after clicking on the “Add Topic” button the “Add Topic” form is displayed.
    • At some point during the creation of the post, scroll down to the “Options” section of the form containing the text “Make this post anonymous” and an associated check box.
    • To post a new topic anonymously, click in check box to the right of “Make this post anonymous” if the check box does not already contain a green check mark.
      • The check box is selected if it contains a green check mark.
    • After completing all of the inputs and selections associated with the new topic post, click on the “Submit Topic” button found at the bottom of the form.

 

  • Posting Anonymously When Creating a Topic Reply Post
  • After installation and activation of the plugin, the post input form displayed to users with permission when entering a topic reply has an additional input field where the originator may designate the reply post in the topic be displayed anonymously (the poster not identified).
  • In the topic view after clicking on the “Add Reply” button the “Add Reply” form is displayed.
  • At some point during the creation of the reply post, scroll down to the “Options” section of the form containing the text “Make this post anonymous” and an associated check box.
  • To post a reply anonymously, click in the check box to the right of “Make this post anonymous” if the check box does not already contain a green check mark.
    • The check box is selected if it contains a green check mark.
  • After completing all of the inputs and selections associated with the reply post, click on the “Submit Reply” button found at the bottom of the form.

Forum Users with proper permission may designate all their posts to be posted anonymously by a selection in their profile.

    • Posting Anonymously on All Posts
Note: This posting option automatically has the “Make this post anonymous” check box pre-selected when the author opens the post creation forms [either create topic or reply topic]. If it is desired to make any given post non-anonymous, the author need only de-select the “Make this post anonymous” check box in the “Options” section of the form to remove the green check mark when creating that particular post. The option to post anonymously will be automatically selected the next time the post creation forms are opened.
  • After installation and activation of the plugin, forum users with the proper permission may edit their profile under the “Options” tab and the “Edit Posting Options” sub-tab to have all their posts displayed anonymously (the poster not identified).
  • On a forum page click on the “Profile” button in the page header to display the “Edit Member Profile” panel.
  • Click on the “Options” tab to display the various edit options.
  • Click on the “Edit Posting Options” sub-tab to display the “Edit Posting Options” for the logged in user.
  • To use anonymous posting for all posts, click in the check box to the right of “Use anonymous posting for all posts:” if the check box does not already contain a green check mark.
    • The check box is selected if it contains a green check mark.
  • Click on the “Update Posting Options” button found at the bottom of the “Edit Posting Options” page to save the setting.
  • To de-select the option at a later time, click on the check box containing a green check mark to remove the check mark then click on the “Update Posting Options” button to save the new setting.
    • The check box is de-selected if it does not contain a green check mark.

Plugin Special Notes

None

 

Template Tags Used in the Plugin

There are no (0) template tags available for this plugin that allows further customization of the plugin’s usage or otherwise customize the website.

Action and Hooks Used in the Plugin

There are no Actions and Hooks available in the Plugin’s Template Tags because there are no template tags.

There are other Actions and Hooks available for this plugin.

    • The following Actions and Hooks are in file

‘sp-anonymous-components.php’

    .

  • apply_filters(‘sph_anonymous_post_label’, __(‘Make this post anonymous’, ‘sp-anonymous’)) – Allows modification of the display code associated with setting up the “Make this post anonymous” check box in the create topic or create response post forms just prior to being output/returned.
  • apply_filters(‘sph_ProfilePostingAnonymous’, $tout) – Allows modification of the display code associated with setting up a user’s profile posting option “Use anonymous posting for all posts” just prior to being output/returned.

 

    • The following Actions and Hooks are in file

‘sp-anonymous-plugin.php’

    .

  • apply_filters(‘sph_ProfileUserAnonymousUpdate’, true)- Allows modification of the code associated with the message sent to users when they save an anonymous post just prior to being output/returned.

Plugin and Template Tag Changelog

Since Simple:Press version 5.5.3.

Codex page sync’d to code version 5.5.11 and plugin version 1.1.0.

More Topics In SimplePress: Plugins


Copyright © 2006-2019 Simple:Press. All Rights Reserved.