What's new

[wmtech] User Blocking System - Manual, Instructions & Installation / Upgrade Guide

Status
Not open for further replies.

wmtech

WMTech Staff
XF Licensee
Messages
214
Reaction score
32
Welcome to WMTech Quality Add-Ons!
We care about our products!


AUTOMATIC INSTALLATION INSTRUCTIONS:

We recommend the use of an automated installation and upgrade system.
Two of them are available for free to download at xenforo.com:
Please try one of them!

*** Note: If you use the product created by Waindigo, please enter the following line to your XenForo configuration file (/library/config.php ) to prevent any callbacks to Waindigo this add-on otherwise starts itself regularly:

Code:
$config['disableCallbacks'] = true

MANUAL INSTALLATION INSTRUCTIONS:
  1. Download the add-on from our products section after licensing it for your forum(s). Please note, that we are enforcing our license. Please do not download, if you don't agree to it!
  2. Upload everything from the "upload" directory in our software package into your web servers forum directory.
  3. Install "addon-blockusers-1xx.xml" in your Xenforo ACP (ACP > Home > Install Add-On).
  4. Access "ACP > Home > Options > [WMTech] User Blocking System" to check and setup the options of this add-on.
  5. Access "ACP > Users > User Group Permissions". Select the user group you wish to assign user self delete control. There is one permission that needs to be set and it is located in the section named 'General Permissions':
    • [WMTech] Can block other users
      Set this to "Allow" to allow this user or user group to block other users
Now you can enjoy our add-on at your board!

Special Installation Instructions (e.g. interactions with other add-ons):
  • None


UPGRADE INSTRUCTIONS:
  1. Download the new version of the add-on from our products section after licensing it for your forum(s). You may need to relicense even free add-ons, if your last version is older than 6 months. Please note, that we are enforcing our license. Please do not download, if you don't agree to it!
  2. Upload everything from the "upload" directory in our software package into your web servers forum directory overwriting all existing files with the new ones!
  3. Go to your Xenforo "ACP > Home > List Add-Ons" and select "[WMTech] User Blocking System". At the dropdown arrow on the right, choose "Upgrade Add-On". A pop-up appears and let you select the XML file "addon-blockusers-1xx.xml" we provide in the upgrade software package.
  4. Access "ACP > Home > Options > [WMTech] User Blocking System" to inspect existing options and setup any new options of this add-on.
  5. Access "ACP > Users > User Group Permissions". Select the user group you wish to inspect or set user blocking control and check the permissions.
This completes an upgrade process and refreshes your board with the enhanced power of a new version.

Special Upgrade Instructions:
  • None so far.


ADMIN MANUAL:

Available Options in ACP:
Home > Options > [WMTech] User Blocking System
  • Enhance XenForo Experience for User Blocking (Prefer Blocking Over Ignoring)?
    This option enhances your XenForo board greatly if you provide the blocking feature to your users. All links to ignore other users are changed to links to block other users. Also an "Ignored Member" is referred to as "Unknown Member".
    If "No" is selected, nothing will be changed with the phrases and links at your forum. The XenForo default 'Ignore' is the master feature and a member with permission to block can block other users only at the designated page in account settings.
    If "Yes" is selected, this add-on's 'Block' becomes the master feature and all links and phrases at your forum will be changed accordingly. If members want to just ignore other users, this can be done only at the designated page in account settings. We recommend to set this option to "Yes".
    Default: No, Recommended: Yes
    Please note: Only members with permission to block other members are affected by this setting.

  • Alter Navigation Link Text?
    This will change the text of the navigation links in account settings and the drop down menu.
    "Use 'People You Ignore'" is the default text used by XenForo.
    "Use 'People You Block'" can be selected as an alternative to emphasize the new blocking feature. This is recommended if you use the Enhance Feature above.
    Default: Use 'People You Inore
    PLEASE NOTE: Only members with permission to block other members are affected by this setting.
    PLEASE ALSO NOTE: You can always just change the XenForo phrase 'people_you_ignore' with the setting "Use 'People You Ignore'" to get a 100% customized look.

  • Disable Unhiding of Hidden Content For Blocked or Ignored Users?
    By XenForo default, if you ignore a user you still can see his content after clicking at a notice asking if you want to see the content.
    If "Always Show Link to Unhide Hidden Content" is selected, this feature remains even for blocked and ignored members.
    If "Never Show Content if Board is Enhanced for Blocking" is selected, this link to unhide hidden content won't be shown for all users affected by the enhancement setting above.
    If "Never Show Content To Anyone Even if Board is Not Enhanced" is selected, the link to unhide the content is not shown to anyone regardless of the enhancement setting above.
    Default: Always Show Link to Unhide Hidden Content
    Recommended: Never Show Content if Board is Enhanced for Blocking

Available Permissions in ACP:
Users > Permissions > User Group Permissions
Users > Permissions > User Permissions
  • [WMTech] Can block other users
    Select "Allow" to allow this user group or this user to block other users totally.

Available Phrases and Templates in ACP:
Appearance > Templates
  • All public templates of this add-on start with "wmt_bu_" The name of the templates is self-explanatory.
Appearance > Template Modifications
  • This add-on uses several template modifications instead of deprecated template hooks. All template modifications are VERY IMPORTANT for this add-on to be able to work. They are designed for the default style only! If you use any custom style, please check if all modifications have been applied correctly by looking at the numbers in the right column of the line with the modification name. If there is a grey or red number, the modification could not be applied thus making this add-on functionless. Contact us or your style designer to solve those issues!
Appearance > Phrases
  • All phrases of this add-on start with "wmt_bu_" The name of the phrases is self explanatory.

Special Usage Informations For Forum Admins:
  • User blocking is available for registered users only. If you have forums which can be accessed by guests, content of blocked users can be seen if the blocking user logs out and looks at the content as a guest.
  • If you do not disable the unhiding of hidden content in your options, the blocked and also the blocking user is able to unhide the hidden content, which is probably not what "User Blocking" is ment to be. We recommend to disable the unhiding of hidden content in your options at least for users with blocking permissions.


USER MANUAL:

If you visit the ignored user management page in your account settings you are able to select other user accounts to be ignored or to be blocked totally. Just check the provided checkbox to block a user instead of just ignoring him.

A total block works like an ignore of the other user and in addition like forcing the other user to also ignore you. Of course a blocked user cannot unignore you. In fact, he won't see you or your content any more (except the admin wants it otherwise). Vice versa you also won't see him or his content any more, except in the ignored user management page in your account settings, where you are able to deactivate the block of the other user.

To deactivate the block of another user, just click at "Stop BLOCKING" at the ignored user management page in account settings.

If the admin of your forum opted for "Blocking" as the default user ignore feature, you can ignore users also with just clicking at "Block" at the other users member card or member profile.

If the admin of your forum opted that hidden content should be able to get unhidden, you or the user you blocked may choose to click at "Show Hidden Content" in any page with hidden content to see your content respectively to see his content.
 
Last edited:
Status
Not open for further replies.
Top