Changes between Version 165 and Version 166 of AccountManagerPlugin


Ignore:
Timestamp:
Mar 3, 2015, 7:52:08 AM (9 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • AccountManagerPlugin

    v165 v166  
    2424}}}
    2525
    26 = Account Manager Plugin =
     26= Account Manager Plugin
    2727
    28 == Description ==
     28== Description
    2929
    3030The AccountManagerPlugin offers features for managing user accounts and more:
     
    3333 * login via an HTML [wiki:AccountManagerPlugin#LoginModule form] instead of using HTTP authentication
    3434 * allow existing users to change their passwords, even delete their accounts
    35  * send a new password to users whove forgotten their password
     35 * send a new password to users who have forgotten their password
    3636 * administration of user accounts
    3737
    38 These features are quite new in the plugin for Trac 0.11 and later
     38These features are quite new in the plugin for Trac 0.11 and later:
    3939 * login failure tracking and rule based account locking (temporary or permanent lock)
    4040 * per-account details admin page
     
    4545 * mostly [wiki:AccountManagerPlugin/WikiMacros account-/user-related WikiMacros]
    4646
    47 == Bugs/Feature Requests ==
    48 total issue record:
     47== Bugs/Feature Requests
     48
     49Total issue record:
    4950[[TicketQuery(component=AccountManagerPlugin,format=progress)]]
    50 open issues by type:
     51Open issues by type:
    5152 [[TicketQuery(component=AccountManagerPlugin,status!=closed&group=type,format=progress)]]
    5253
    5354Check [query:?component=AccountManagerPlugin&order=priority existing bugs and feature requests] first, please. If you have additional issues, you're welcome to ask at our [trac:MailingList mailing-list] to confirm proper local install and configuration. Only create a
    54 [http://trac-hacks.org/newticket?component=AccountManagerPlugin&owner=hasienda new ticket], if you're reasonably sure, that it will be a valid defect report or a generally useful enhancement. Thanks for taking care.
     55[http://trac-hacks.org/newticket?component=AccountManagerPlugin&owner=hasienda new ticket], if you're reasonably sure, that it will be a valid defect report or a generally useful enhancement.
    5556
    5657You do wonder, if you could contribute here? Great! Read some recommendations on [wiki:AccountManagerPlugin/TicketBurndown where to start]. In any case, please respect our [wiki:License/MandatorySignOff rules for contributions], that are enforced for this plugin as of 01-Dec-2012.
    5758
    58 == Install ==
    59 === Prerequisites ===
    60 First make sure you’ve [trac:wiki:TracPlugins#Requirements installed setuptools].  Make sure you have a version >= 0.6c9, since previous versions contain a bug which makes the installation fail. Then you can install the plugin using the `easy_install` application.
     59== Installation
     60=== Prerequisites
     61
     62First make sure you’ve [trac:wiki:TracPlugins#Requirements installed setuptools]. Make sure you have a version >= 0.6c9, since previous versions contain a bug which makes the installation fail. Then you can install the plugin using the `easy_install` application.
    6163
    6264'''Note:''' Windows users will need to [http://peak.telecommunity.com/DevCenter/EasyInstall#windows-notes add easy_install to their PATH].
    6365
    64 === Release Status, Downloads and Source ===
     66=== Release Status, Downloads and Source
    6567
    6668|| '''Stable Version''' ||easy_install https://trac-hacks.org/svn/accountmanagerplugin/tags/acct_mgr-0.4.4 ||[download:accountmanagerplugin/tags/acct_mgr-0.4.4 download] ||[http://trac-hacks.org/svn/accountmanagerplugin/tags/acct_mgr-0.4.4 subversion] ||
    6769|| Under Development ||easy_install https://trac-hacks.org/svn/accountmanagerplugin/trunk ||[download:accountmanagerplugin/trunk download] ||[http://trac-hacks.org/svn/accountmanagerplugin/trunk subversion] ||
    6870
    69 Which version is best you? Likely the stable release, if not explicitly told otherwise. '''It works for any release starting from Trac 0.11 to 1.1.1.'''
     71Which version is best for you? Likely the stable release. '''It works for any release starting from Trac 0.11 to 1.1.1.'''
    7072
    71 [source:/accountmanagerplugin Browse the source] with Trac to see more. I.e. there is the [source:/accountmanagerplugin/tags /tags] branch containing latest stable as well as previous plugin revisions by version tag. For Subversion checkout use {{{svn co <url>}}} with appropriate URL (i.e. see links above).[[BR]]
    72 Code from branches suggesting the corresponding Trac version is available too, and it is in sync with tagged versions. But there is no `0.12`, and it will never be. Code from `0.11` branch works equally well for all Trac starting from 0.11 up to Trac 1.0 (current stable). Once we'll get to `acct_mgr-0.6` there will be a `1.0` folder indicating 'for Trac 1.0 or later'.[[BR]]
     73[source:/accountmanagerplugin Browse the source] with Trac to see more, ie there is the [source:/accountmanagerplugin/tags /tags] branch containing the latest stable as well as previous plugin revisions by version tag. For Subversion checkout use {{{svn co <url>}}} with appropriate URL, see links above.
     74
     75Code from branches suggesting the corresponding Trac version is available too, and it is in sync with tagged versions. There will not be a version `0.12`. Code from `0.11` branch works equally well for all Trac starting from 0.11 up to Trac 1.0 (current stable). Once `acct_mgr-0.6` is released there will be a `1.0` folder indicating 'for Trac 1.0 or later'.
     76
    7377Only if you inherited a really old install, the obsolete [source:accountmanagerplugin/0.10 0.10 branch] could still be interesting.
    7478
    75 '''Hint:''' Whether you are using `tracd` standalone server or a web-server, you must restart it to detect and load the plugin.
     79'''Hint''': Whether you are using `tracd` standalone server or a web-server, you must restart it to detect and load the plugin.
    7680
    77 '''On upgrades from previous plugin versions''' please see the [source:accountmanagerplugin/trunk/README.update README.update] file included in the source.
     81'''Upgrades from previous versions''': Please see the [source:accountmanagerplugin/trunk/README.update README.update] file included in the source.
    7882
    79 === About i18n/l10n support ===
     83=== About i18n/l10n support
     84
    8085Starting with acct_mgr-0.3 this plugin has been prepared for localization.[[BR]]
    81 But English message texts are still the (POSIX) default. If this isn't your preferred language, you can
    82  1. look, if it's already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/acct_mgr Transifex] or
    83  2. do it yourself (see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details).
     86But English message texts are still the (POSIX) default. If this isn't your preferred language, you can:
     87 1. check if it's already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/acct_mgr Transifex] or
     88 1. do it yourself, see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details.
    8489
    85 You've done a new translation? Superb! Contributing your translation is highly appreciated.[[BR]]
    86 You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project]
    87 via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:
     90You've created a new translation? Superb! Contributing your translation is highly appreciated. You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project] via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:
    8891
    8992Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/acct_mgr/ acct_mgr][[BR]]
     
    100103Again, for more details see the [t:wiki:CookBook/PluginL10N#Compileanduseit l10n cookbook page for Trac plugins].
    101104
    102 == Setup ==
    103 === Components ===
     105== Setup
     106=== Components
     107
    104108In order to use the features of the !AccountManager you will need to enable some or all of its components.
    105109The available components are mentioned here, but are described in greater details on separate pages linked below.
     
    114118||[wiki:AccountManagerPlugin/RegistrationInspector#EmailVerificationModule EmailVerificationModule] ||An new email address will trigger an email with a verification code to enter, to approve it is really users own email address, and user account privileges cut down until successful verification. ||Implement a verification process for added or changed email addresses, if required. See [wiki:AccountManagerPlugin/RegistrationInspector#EmailVerificationModule details]. ||
    115119^1^ Name in acct_mgr-0.3 was `AccountManagerAdminPage`. If you are upgrading to acct_mgr-0.4 from an earlier version, and this feature was enabled using `acct_mgr.admin.AccountManagerAdminPages`, this feature will now be disabled until it is enabled using `acct_mgr.admin.AccountManagerAdminPanel`.[[BR]]
    116 ^2^ Found in `trac.ini`[[BR]]
    117 ^3^ Change their password, or even delete their account, if permission granted by appropriate configuration[[BR]]
    118 ^4^ Same menu bar as the “Login” link
     120^2^ Found in `trac.ini`.[[BR]]
     121^3^ Change their password, or even delete their account, if permission granted by appropriate configuration.[[BR]]
     122^4^ Same menu bar as the “Login” link.
    119123
    120 The easiest way to learn about available components and enable them is via Trac's plugin admin page (before Trac 0.11 this has been a separate trac:WebAdmin plugin). Users logged in with the TRAC_ADMIN permission will be able to manage the enabled components:
     124The easiest way to learn about available components and enable them is via Trac's plugin admin page. Before Trac 0.11 this has been a separate trac:TracWebAdmin plugin. Users logged in with the TRAC_ADMIN permission will be able to manage the enabled components:
    121125
    122126[[Image(components-admin_acct_mgr-0.4.png)]]
     
    124128Components can also be enabled or disabled in the [trac:TracIni trac.ini] file under the `[components]` section.
    125129
    126 === Configuration ===
    127 You might feel overwhelmed by component dependencies, the number of options and their relation to components.
    128 This is a known issue, but is currently worked on, see #8930.
     130=== Configuration
    129131
    130 Meanwhile [wiki:CookBook/AccountManagerPluginConfiguration configuration cookbook] is the single most recommended place to look for examples of basic configurations and more.
     132The number of component dependencies, options and their relation to components is currently worked on, see #8930.
    131133
    132 == Post Setup/Configuration ==
    133 In order to use the !AccountManager plugin, while logged in as a user owning `TRAC_ADMIN` rights, use the “Admin” link on the menubar.
     134The [wiki:CookBook/AccountManagerPluginConfiguration configuration cookbook] is the recommended place to look for examples of basic configurations and more.
    134135
    135 You might want to change some permission assignments.  For instance, if you remove `TICKET_MODIFY` and `WIKI_MODIFY` permission from the “anonymous“ group and add it to the “authenticated” group instead, only authenticated, logged-in (registered) users can perform ticket modifications and wiki editing.
     136== Post Setup/Configuration
    136137
    137 `TRAC_ADMIN` is not strictly required for access to account administration pages provided by !AccountManager. The `ACCTMGR_*` permissions are sufficient, and should even be preferred where appropriate, i.e. to limit delegation of administrative tasks to just account administration by granting `ACCTMGR_USER_ADMIN`.
     138In order to use the !AccountManager plugin, while logged in as a user owning `TRAC_ADMIN` rights, use the "Admin" link on the menubar.
    138139
    139 == Recent Changes ==
     140You might want to change some permission assignments. For instance, if you remove `TICKET_MODIFY` and `WIKI_MODIFY` permission from the "anonymous" group and add it to the “authenticated” group instead, only authenticated, logged-in (registered) users can perform ticket modifications and wiki editing.
     141
     142`TRAC_ADMIN` is not strictly required for access to account administration pages provided by !AccountManager. The `ACCTMGR_*` permissions are sufficient, and should even be preferred where appropriate, ie to limit delegation of administrative tasks to just account administration by granting `ACCTMGR_USER_ADMIN`.
     143
     144== Recent Changes
     145
    140146[[ChangeLog(/accountmanagerplugin,3)]]
    141147
    142148See [/log/accountmanagerplugin more]
    143149
    144 == Author/Contributors ==
     150== Author/Contributors
    145151
    146152'''Author:''' [wiki:mgood] [[BR]]