Simple:Press Documentation

Plugin: Post As

Plugin Description

Plugin: Post As – This Simple:Press plugin allows Forum Administrators and allowed forum users to post as another user.

WARNING: The ability to post as another forum user is very powerful. Great care should be exercised when determining which forum users should have the permission.

Plugin Features

Installing this Simple:Press plugin adds:

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

Activating this plugin provides:

  • A change to the new “Post As” section in the Plugin Management panel under the Admin menu path Forum > Plugins > Available Plugins so the plugin can be deactivated, or uninstalled.
    • There are no options for this plugin.
    • The “Getting Started” link associated with the “Deactivate/Uninstall” selections should be selected to view the pertinent information regarding the plugin.

For All Forum Administrators and Forum Users with the Proper Permission

Note:
The post attributes of the real author of the post are assigned to the post.

  • If the real author requires post moderation but the “Post As” author does not, the post WILL require moderation.
  • Conversely, if the real author does not require post moderation but the “Post As” author does, the post WILL NOT require moderation.
    • A new check box “Change Post author” in the “Options” section of the “Add Topic” form where the logged in user can make the author of the post another forum member.
      • When the check box is selected, immediately below the check box a “Post as:” text input box appears where the name (not the display name or username) of the member who is to be listed as the author of the post is input.
      • As the user’s name is being typed, the name will auto-complete if a valid member name is being input.
    • A new check box “Change Post author” in the “Options” section of the “Add Reply” form where the logged in user can make the author of the reply post another forum member.
      • When the check box is selected, immediately below the check box a “Post as:” text input box appears where the name (not the display name or username) of the member who is to be listed as the author of the post is input.
      • As the user’s name is being typed, the name will auto-complete if a valid member name is being input.

There is one (1) new permission added to the permission sets due to this plugin.

  • Can create a forum post as different user

Plugin Requirements

Requires Simple:Press version 5.5.4 and above.

This plugin must be installed, and activated before it is operational.

As part of the installation, a “Post As” section is added to the Plugin Management panel under the admin menu Forum > Plugins > Available Plugins. From this panel the plugin can be activated, deactivated, uninstalled, or deleted.

  • There are no options that need be set up for this plugin.

There is one (1) new permission added to the permission sets due to this plugin.

  • Can create a forum post as different user

The plugin does not have template tags so no recommendation regarding Custom or Child Themes is being made.

Installing and Activating

Please see Using Plugins on how to obtain and install this 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 “post-as“.
  • 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 “post-as.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 As” plugin and click on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall” with a “Get Started” Link.

  • The “Getting Started” link associated with the “Deactivate/Uninstall” selections 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”.
To re-activated the plugin, click on on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall”.

Plugin Administrative Options

After installing and activating, there are no Administrative Options to be set 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.

WARNING: The ability to post as another forum user is very powerful. Great care should be exercised when determining which forum users should have the permission.
  • Assigning New Permissions
    • “Can create a forum post as different user” permission
      • Allowing users to create a post as another user in the forum is controlled by their group permissions.
      • Each usergroup that is to have this 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 “Creating” click the check box next to “Can create a forum post as different user” to set/enable the permission. When enabled, the check box contains a green check mark.
      • If there are no other permissions to set, click the “Update Permission” button 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 As 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 As” 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 As” 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 Admins uses this plugin to post topics and replies as if they were authored by another forum member.
Forum User with the “Can create a forum post as different user” can use this plugin to post topics and replies as if they were authored by another forum member.

Note:
The post attributes of the real author of the post are assigned to the post.

  • If the real author requires post moderation but the “Post As” author does not, the post WILL require moderation.
  • Conversely, if the real author does not require post moderation but the “Post As” author does, the post WILL NOT require moderation.
  • Creating a New Topic Post and Posting As Another User
  • Navigate to a forum or a topic in a forum and click the “Add Topic” button to display the “Add Topic” form.
  • At some point while completing the post, scroll down to view the “Options” section of the form.
  • In the “Options” section, click on the check box to the left of “Change Post Author” to select it and to display immediately below the check box the “Post As:” text input box.
    • The check box is selected if there is a green check mark in it.
    • Clicking a check box containing a green check mark removes the check mark and deselects the check box.
  • In the text input box to the right of “Post As:” begin typing the name (not username nor display name) of the forum user to be listed as the author of the post.
    • As the user’s name is being typed, immediately below the text box the auto-complete function will display a drop down menu with valid member name(s).
  • Click on the desired member’s name in the drop down menu to select it and move it to the “Post As:” text input box.
  • After completing the sections of the new topic post, click on the “Submit Topic” button at the bottom of the form to submit the topic post.
  • The “Post As” member’s name will be listed as the author of the post in the forum.
  • Creating a New Reply Post and Posting As Another User
  • Navigate to a topic in a forum and click the “Add Reply” button to display the “Add Reply” form.
  • At some point while completing the post, scroll down to view the “Options” section of the form.
  • In the “Options” section, click on the check box to the left of “Change Post Author” to select it and to display immediately below the check box the “Post As:” text input box.
    • The check box is selected if there is a green check mark in it.
    • Clicking a check box containing a green check mark removes the check mark and deselects the check box.
  • In the text input box to the right of “Post As:” begin typing the name (not username nor display name) of the forum user to be listed as the author of the post.
    • As the user’s name is being typed, immediately below the text box the auto-complete function will display a drop down menu with valid member name(s).
  • Click on the desired member’s name in the drop down menu to select it and move it to the “Post As:” text input box.
  • After completing the sections of the new topic post, click on the “Submit Reply” button at the bottom of the form to submit the reply post.
  • The “Post As” member’s name will be listed as the author of the post in the forum.

Plugin Special Notes

WARNING: The ability to post as another forum user is very powerful. Great care should be exercised when determining which forum users should have the permission.

Template Tags Used in the Plugin

There are no Template Tags used in this plugin.

Actions and Hooks Used in the Plugin

There are no Actions and Hooks available in Template Tags for this plugin.

There are no other Actions and Hooks available in this plugin to modify aspects of this plugin.

Plugin and Template Tag Changelog

Since Simple:Press version 5.0.

Codex page sync’d to code version 5.6.3 and plugin version 1.1.6

More Topics In SimplePress: Plugins


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