Simple:Press Documentation

Plugin: Post to Multiple Forums

Plugin Description

Plugin: Post to Multiple Forums – This Simple:Press plugin allows for a new topic to be posted in multiple, selectable forums (cross posting).

Plugin Features

Installing this Simple:Press plugin adds:

  • A new “Post Multiple Forums” section in the Plugin Management panel under the Admin menu path Forum – Plugins – Available Plugins. From this panel the Simple:Press “Post to Multiple Forums” plugin can be activated, or deleted by the admin.

Activating this plugin provides:

  • A change to the new “Post Multiple Forums” section in the Plugin Management panel under the Admin menu path Forum – Plugins – Available Plugins so the Simple:Press “Post to Multiple Forums” plugin can be deactivated, uninstalled, and have it Options set.
  • A new “Post Multiple Forums” admin screen with an Options section with a radio button and name of each forum available for posting multiple are listed. The radio button for the forum is selected (turned green) if the forum is to NOT be included in the list of forums for posting multiple. The “Help” link should be used for assistance in setting up the options.
  • A new “Post Multiple” sub-menu entry under the Admin Forum menu “Components” entry linked to the new “Post Multiple Forums” screen for excluding forums for posting multiple.
  • A new permission “Can create a new topic in multiple forums” that must be enabled in the permissions sets for usergroups being allowed to post multiple.
  • A new section in the input screen for a New Topic below the text input section where the originator can select the other forums to receive the new topic from the list of allowed forums. This section will only show up for new topic originators having the new permission enabled in their usergroup permission set.

Plugin Requirements

Simple:Press version 5.5.4 and above is required.

The Simple:Press plugin must be installed, activated, and its options set before it is operational.

As part of the installation, a “Post Multiple Forums” section is added to the Plugin Management panel under the admin menu Forum – Plugins – Available Plugins. From this panel the Post Multiple plugin can be activated, deactivated, uninstalled, deleted, or its options set up using its “Activate/Delete” and “Deactivate/Uninstall/Options” selections.

As part of the activation, a new permission “Can create a new topic in multiple forums” is added to the permission sets. This permission must be enabled in the permission sets for usergroups being allowed to post multiple.

The plugin does not have template tags incorporated into current themes so developing a Custom or Child Theme to accommodate any desired template tag changes is not needed before installing this plugin. Information on Child Themes is located on our Creating a Child Theme page. Information on creating and installing themes is located on our Creating a Custom Theme page.

Plugin Installation and Activation

Please see Using Plugins on how to obtain and install the Simple:Press Post Multiple plugin.

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” and then “Plugins” from the drop down Forum Admin menu. On the Simple:Press Administration panel select the “Post Multiple Forum” plugin on the “Plugin Management” panel and click on “Activate”. The “Activate/Delete” label changes to “Deactivate/Uninstall/Options”. To deactivate the plugin, click on “Deactivate”. The “Deactivate/Uninstall/Options” label changes to “Activate/Delete”.

Plugin Administrative Options

After activation, a) on the aforementioned “Available Plugins” page and “Plugin Management” panel, click “Options” on the “Post Multiple Forum” plugin section or b) under the “Components” entry on the forum menu on the left side forum admin page click the “Post Multiple” sub-menu item to get the Post Multiple Forums panel with “Options”section.

  • Selecting “Options”
    • In this section, one can choose which forums to include and which to exclude from the list of possible forums to allow cross posting.
      • This is a global, alternate way to controlling which forums can get cross postings. More importantly, if there is a standard set of forums where cross posting is desired, this allows the admin to reduce the number of forums listed for the user to select by excluding those where cross posting will not be allowed.
    • Click on the radio button to the left of the forum name to remove the forum from the list of available cross posting forums the users will see. The radio button indicates it is selected (the forum is excluded) by turning green in color. Allow a forum to be in the cross posting list by clicking the radio button if it is colored green. The radio button indicates it is deselected (the forum is included) by turning gray in color.
      • If all forums are to be allowed to receive cross postings, all the radio buttons for all the forums should be left unselected (gray in color).
    • Click on the “Update” button to save the setting if no other changes are to be made in the panel. Otherwise, wait to click the “Update” button until all desired changes have been made.

From the Forum Admin menu on the left of admin pages, open the “Permissions” entry, to see the sub-menu and select “Manage Permission Sets”.

  • Assigning Permissions
    • Allowing users to post multiple is controlled by their group permissions.
    • Each member group that is to have the ability to post multiple (cross post) must have a create new permission turned on.
    • This is accomplished from the Admin menu by navigating to Forum – Permissions and selecting “Manage Permissions Sets” in its sub-menu.
    • Select “Edit Permission” for the permission set to be updated to view the “Permissions – Manage Permissions” panel.
    • Under “Creating” click the radio button next to the new permission “Can create a new topic in multiple forums” to set/enable the permission. When enabled, the radio button is green in color.
    • Click “Update Permission” at the bottom of the permission set to have the selection saved.
    • At a later time clicking a radio button when it is green removes the green color and will remove the permission when followed by clicking “Update Permission” to save the revised selection.
    • Repeat the process above for each permission set to have the permissions updated to allow cross posting.

Plugin Language Translation

A plugin’s message strings can be translated from English to other languages and then the translation displayed if language translation files are available. Some plugins may not have such files.

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

More information is available regarding translation files at Simple:Press Translations. 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.

The Post to Multiple Forums plugin’s available language translation files with translation statistics, and message translations can be viewed at Post to Multiple Forums Translations. Select the Version link to see the languages available. Select the link for the desired language to see forum messages and their available translations. If available, export the file for the selected language to its proper forum language sub-folder as a “mo” file using the export link at the bottom of the page displaying the actual message translations for the language selected.

The default location for Simple:Press plugin language files is …/wp-content/sp-resources/forum-language/sp-plugins. If this path is changed, it is important to note that the plugin’s language file needs to reside in the language sub-folder for sp plugins wherever it has been moved and however it has been renamed. See Storage Locations for more information.

Plugin Usage

Forum users and admins use this plugin.

  • Assigning Forums for Post Multiple on New Topics
    • After installation and activation of the plug, the input form displayed to users when entering a new topic has an additional input field where the originator may select the other forums available for posting multiple by selecting the radio button associated with each of the forums.
    • After entering the title and text into the new topic input fields the additional forums can be selected in the “Select additional forums to create this new topic in” area. In this area of the form the originator can:
      • View the  forums allowed for posting multiple (cross posting). The forums are listed by name to the right of a radio button associated with that forum.
      • Click on the radio button to the left of the forum name to select the forum. The radio button indicates it is selected by turning green in color. Deselect a forum by clicking the radio button if it is colored green. The radio button indicates it is deselected by turning gray in color.
      • After any other selections or necessary actions for the new topic post have been made, click the “Submit Topic” button at the bottom of the input forum to submit the new topic to the multiple forums selected.

Plugin Special Notes

If there are no forums for the user to cross post in, the user is notified by the text “You do not have permission to post in any other forums”.

Template Tags Used in the Plugin

There are no Template Tags available for this plugin that allows the admin to further customize it’s usage or otherwise customize the website.

Actions and Hooks Used in the Plugin

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

There are other Actions and Hooks available for this plugin.

Used in file sp-post-multiple-components.php

  • apply_filters(‘sph_post_multiple_form’, $temp) – Allows modification of the display code just prior to being output/returned. $temp will contain the html code.

Plugin and Template Tag Changelog

Since Simple:Press version 5.5.0.

Codex page sync’d to code version 5.5.3.

More Topics In SimplePress: Plugins


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