Index of /Forum/mods/custom-title-2.0_beta2/contrib

Name	Last modified	Size

Parent Directory		-
upgrade_2.0.B1_to_2...>	2012-02-06 13:14	4.6K

Custom Title MOD 2.0 Beta 2 README

Custom Title MOD 2.0 Beta 2

Author: Aexoden (http://www.aexoden.com)

Thank you for downloading my custom title MOD. This document contains several bits of useful information. Please read the entire thing. Any questions that are answered in this document will be met with a terse reply. This document is designed to limit the amount of basic support I need to provide. Please assist in reducing my workload. Thanks!

Features
Installation
Configuration
Bug Reports
Donations
Changelog

I. Features

Three different modes of operation, which allow the administrator to customize the output without editing the templates.
Titles can be configured to only activate after a certain number of days of membership and posts.
The ability to edit one's own custom title is a full-fledged permission in the phpBB permission system, allowing for group and user-level control
Another permission allows certain users or groups to ignore the days of membership and posts requirements.
The maximum length is fully configurable (from 2 to 255 characters).

II. Installation

Installation can either be a simple (if time-consuming) process or a very difficult one, depending on how much attention you pay to what you're doing. Be careful! Just follow the instructions and you should be okay.

Follow the instructions in install.xml. This includes making changes to your database, preferably with a tool like phpMyAdmin. There may be other ways to make the necessary changes. Please pay special attention to the DIY instructions at the end of the file. They are critical if you intend to change MOD settings via the ACP or if you wish to avoid database errors.
If you're using subsilver2, follow the instructions in subsilver2.xml. If you have templates other than prosilver or subsilver2 installed, you may have to figure out the appropriate modifications on your own. subsilver2 is probably a better base to start from unless your template was derived from prosilver.
Read the configuration section below.

III. Configuration

This MOD ships with several different options to customize the operation of the custom title system. This section details each option and how it works.

Mode of Operation

No Replacement (default) - If the user enters a custom title, it will appear on their posts and profiles as a separate bold title. If they enter nothing, no changes will appear.
Replace Rank Only - If a user enters a custom title, it will replace their default rank based on posts. However, the rank image associated with their default rank will remain. This is a useful compromise between the other two modes.
Replace Rank and Image - If a user enters a custom title, it will replace both their default post-based rank and the associated rank image.

Criteria for Activation

These two options allow you to configure the time and posts it takes to gain the use of a custom title. These options can be overridden, and a user can have their title manually activated or disabled by an administrator.

Maximum Length

This sets the maximum allowable length for users' custom titles.

Permissions

Two new permissions have been added as a result of installing this MOD. The first determines whether or not a user can edit his title at all. The second determines whether or not they can ignore the days of membership and post count requirements.

Note: By default, both permissions are set to no. Before anyone on your forum can set her custom title, you must give a user/group/user role this permission.

IV. Bug Reports

If you discover a bug in the installation process or in the MOD itself, please report it. (One rather serious bug once went unreported for six months.) The best ways to report it are to send me an e-mail, or to visit my support forum. There also may be a thread on the phpBB support site.

In addition, you'll always find the latest patches and language packs on my Custom Title MOD web site.

V. Donations

If you enjoy the MOD and get use out of it, and feel that it's worth anything, consider donating. While I would love to spend all my time on projects like this, the bills have to get paid, too. Thanks!

VI. Changelog

1.0.x series (for phpBB 2.0.x)

Version	Date	Changes
0.9.0	03 Aug 2002	Initial public release
0.9.1	04 Aug 2002	Removed a commented out section of code from an earlier internal version. Only served to make more work for the MOD installer.
0.9.2	04 Aug 2002	Added a missing line of code in admin/admin_users.php
0.9.3	Unreleased	In reponse to user feedback, added the ability to choose from three different modes of operation.
0.9.4	15 Aug 2002	Added the ability for administrators to set the maximum allowable title length. Also added EasyMOD Alpha 2 compliance.
0.9.5	23 Aug 2002	Based on feedback from Nuttzy99, made a couple of changes to ensure EasyMOD compliance. Also repackaged the Easymod_install.zip as to not include superfluous directories.
0.9.5.1	20 Sep 2002	Corrected a minor typo in manual_install.txt. grumble
1.0.0	02 Feb 2003	Small changes in input processing, following similar changes in phpBB 2.0.4. MOD Database submitted.
1.0.1	09 Mar 2003	Corrected a bug involving activation upon a certain number of registration days.
1.0.2	07 May 2003	Thanks to ComradeF, corrected a bug that allowed users to set their title during registration, even if there was a days of registration requirement.
1.0.3	26 May 2006	Updated to reflect changes in phpBB 2.0.20. No longer compatible with older versions.

2.0.x series (for phpBB 3.0.x)

Version	Date	Changes
2.0.A1	15 Aug 2007	Rewrote MOD for compatibility with phpBB 3.0.RC4. phpBB 2.0.x users should stick with 1.0.3.
2.0.A2	23 Aug 2007	Fixed some missing code in Alpha 1.
2.0.B1	23 Dec 2007	Thanks to Gremlinn and spacefish, added subsilver2 template. Updated prosilver template to phpBB 3.0.0.
2.0.B2	23 Jul 2008	Fixed a few bugs and updated to MODX 1.2.0.