larger smaller normal text version of this page

Revision [1544]

Last edited on 2008-04-16 05:01:41 by AlStillero [some edits, some additions]
Additions:
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;1 ;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;*** NOT OPERATIONAL - do not use this setting***;Additional data;;?????;Foreign Key;;The Foreign Key field is meant to establish a relationship between the database of Phplist and another application's database. If you only use Phplist, you will not need to use it.;Country; [pulldown menu]; One example of attribute. All the other attributes begin to be listed at this point."}}
~This feature must be enabled by the site administrator with the ##''ASKFORPASSWORD''## setting in config.php. If enabled, each user can choose his/her personal password which will allow him/her to modify his/her personal file in the preferences pages.
~If you use passwords, you can store them encrypted or in plain text. If you want to encrypt them, you will need to enable the ##''ENCRYPTPASSWORD''## setting in config.php. **Note**: if you use encrypted passwords, users can only request you as an administrator to reset the password. They will not be able to request the password from the system.
Deletions:
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;1 ;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;The Foreign Key field is meant to establish a relationship between the database of Phplist and another application's database. If you only use Phplist, you will not need to use it.;Country; [pulldown menu]; One example of attribute. All the other attributes begin to be listed at this point."}}
~This feature must be enabled by the site administrator. If enabled, each user can choose his/her personal password to modify his/her personal file in the preferences pages. ''how does this work? is it encrypted?''

Revision [809]

Edited on 2006-10-17 07:59:01 by AlStillero [added breadcrumb trail]
Additions:
==[[PhplistDocumentation Phplist Documentation]] » [[ListAndUserFunctionsInfo List and User functions]] » [[ListUsersInfo Users]] » ==
Deletions:
[[PhplistDocumentation phplist Documentation]]

Revision [743]

Edited on 2006-09-21 20:37:37 by HernoL [minor change]
Additions:
~Delete will delete the user from all lists and also from the database.
Deletions:
##**Delete will delete user from the list**##
~''from what list? ? This must be an ERROR, and should read: this will delete the user from the database, no?''
~''see remark above''

Revision [680]

Edited on 2006-08-09 03:26:33 by AlStillero [Explanation Foreign Key]
Additions:
In phplist, a **user** corresponds to one email. Each email, in turn, is linked to a ##user file## in which are stored values chosen among the list of available [[ConfigureAttributesInfo attributes]]. These attributes can be chosen by the user him/herself if they are listed in the [[ConfigureSubscribePageInfo subscribe pages]], or by the admins if they are only listed in the admin area.
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;1 ;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;The Foreign Key field is meant to establish a relationship between the database of Phplist and another application's database. If you only use Phplist, you will not need to use it.;Country; [pulldown menu]; One example of attribute. All the other attributes begin to be listed at this point."}}
Deletions:
In phplist, a **user** corresponds to one email. Each email, in turn, is linked to a ##user file## in which are stored values chosen among the list of available [[ConfigureAttributesInfo attributes]]. These attributes can be chosen by the user him/herself if they are listed in the [[ConfigureSubscribePagesInfo subscribe pages]], or by the admins if they are only listed in the admin area.
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;????;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;never used... please explain!;Country; [pulldown menu]; One example of attribute. All the other attributes begin to be listed at this point."}}

Revision [599]

Edited on 2006-07-17 16:01:08 by HernoL
Additions:
[[PhplistDocumentation phplist Documentation]]
In phplist, a **user** corresponds to one email. Each email, in turn, is linked to a ##user file## in which are stored values chosen among the list of available [[ConfigureAttributesInfo attributes]]. These attributes can be chosen by the user him/herself if they are listed in the [[ConfigureSubscribePagesInfo subscribe pages]], or by the admins if they are only listed in the admin area.
~A unique string is given to each user by phplist. This string is used in personalized ""URLs"" to confirm one's subscription (confirmationURL), to modify one's preferences, etc. In most systems, for instance, to reach the preferences pages for a given user, you paste this string after the following URL: ##...mysite.com/lists/?p=preferences&uid=## (##...mysite.com/lists/?p=preferences&uid=41f0e3d602a3d253498...## in this example).
Deletions:
[[PhplistDocumentation Phplist Documentation]]
In PHPlist, a **user** corresponds to one email. Each email, in turn, is linked to a ##user file## in which are stored values chosen among the list of available [[ConfigureAttributesInfo attributes]]. These attributes can be chosen by the user him/herself if they are listed in the [[ConfigureSubscribePagesInfo subscribe pages]], or by the admins if they are only listed in the admin area.
~A unique string is given to each user by PHPlist. This string is used in personalized ""URLs"" to confirm one's subscription (confirmationURL), to modify one's preferences, etc. In most systems, for instance, to reach the preferences pages for a given user, you paste this string after the following URL: ##...mysite.com/lists/?p=preferences&uid=## (##...mysite.com/lists/?p=preferences&uid=41f0e3d602a3d253498...## in this example).

Revision [504]

Edited on 2006-03-27 20:40:15 by YanB [adding note on how to unblacklist user]
Additions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from one or various lists. By unsubscribing a user this way instead of doing it in the admin area (by unticking the subscription to lists), the user will receive a confirmation email saying he/she has been **permanently unsubscribed** from the system. In other words, the user has been **blacklisted**. To remove a user from the blacklist, go to the user's [[UserHistoryInfo history]].
Deletions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from one or various lists. By unsubscribing a user this way instead of doing it in the admin area (by unticking the subscription to lists), the user will receive a confirmation email saying he/she has been **permanently unsubscribed** from the system. In other words, the user has been **blacklisted**.

Revision [501]

Edited on 2006-03-27 18:44:01 by YanB [note on blacklisting]
Additions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from one or various lists. By unsubscribing a user this way instead of doing it in the admin area (by unticking the subscription to lists), the user will receive a confirmation email saying he/she has been **permanently unsubscribed** from the system. In other words, the user has been **blacklisted**.
Deletions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from one or various lists. By unsubscribing a user from lists this way instead of doing it in the admin area, the user will receive a confirmation email with all the changes. Otherwise, the user would receive no email informing him/her that he/she has been unsubscribed from this or that list.

Revision [330]

Edited on 2005-07-27 13:22:58 by YanB [blacklisting]
Additions:
~{{table columns="5" cells="delete; john@web.com ; update page ; unsubscribe page ; history"}}
~When a user chooses to unsubscribe from your mailinglist system, the user is considered as blacklisted. Currently, the only way to blacklist a user is to go to the public ##/?p=unsubscribe## page and follow the instructions.
Deletions:
~{{table columns="5" cells="delete; john@web.com ;  update page ; unsubscribe page ; history"}}

Revision [159]

Edited on 2005-03-26 19:14:30 by YanB [done]
Additions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from one or various lists. By unsubscribing a user from lists this way instead of doing it in the admin area, the user will receive a confirmation email with all the changes. Otherwise, the user would receive no email informing him/her that he/she has been unsubscribed from this or that list.
Deletions:
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from your database. See ''unsubscribe (add link)'' for more. ''Question: does this correspond to //blacklisting// a user?''

Revision [145]

Edited on 2005-03-19 09:52:37 by YanB
Additions:
In PHPlist, a **user** corresponds to one email. Each email, in turn, is linked to a ##user file## in which are stored values chosen among the list of available [[ConfigureAttributesInfo attributes]]. These attributes can be chosen by the user him/herself if they are listed in the [[ConfigureSubscribePagesInfo subscribe pages]], or by the admins if they are only listed in the admin area.
A ##User File## contains the list of **all** the existing attributes, with the corresponding values for each user. It also contains the list of mailinglists the admin owns, and shows to which of these the user is subscribed.
Only admins have access to ##user files##, and they can modify all the information for each user using this page.
~To return to the [[ListUsersInfo List Users]] page, where you left off before clicking on a user's email (for example, if you were listing users 150 to 200, you will return to the same page).
~To return to the [[ListUsersInfo List Users]] page, as you left it after having done a search (for example, if you searched all emails with "domain.com", you will return to the list displaying the results of this search).
~To view the ##preferences## page as it appears to the user when he/she clicks on their personal link (//preferencesurl//). By modifying a user's file this way instead of doing it in the admin area, the user will receive a confirmation email with all the changes. Otherwise, the user would receive no confirmation email.
~To view the public ##unsubscribe## page, as it appears to the user when he/she wishes to unsubscribe from your database. See ''unsubscribe (add link)'' for more. ''Question: does this correspond to //blacklisting// a user?''
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;????;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;never used... please explain!;Country; [pulldown menu]; One example of attribute. All the other attributes begin to be listed at this point."}}
~When a user subscribes to one of your lists, a confirmation email is automatically sent to the email provided in the subscribe page. The user must click on the personal CONFIRMATIONURL contained in the email to confirm his/her subscription. Unconfirmed users do not receive any messages sent to lists. An admin can confirm a user manually by replacing 0 with 1.
~This feature allows you to mark a user as having chosen to **never** receive anymore emails from this system. The user's email //remains// in the database in order to avoid someone/something from subscribing the user //again// to the system //without// his/her knowledge.
~The number of bounced messages. A bounced message is a message that did not reach the user for a number of possible reasons. For more, see ''bounced messages...''
~A unique string is given to each user by PHPlist. This string is used in personalized ""URLs"" to confirm one's subscription (confirmationURL), to modify one's preferences, etc. In most systems, for instance, to reach the preferences pages for a given user, you paste this string after the following URL: ##...mysite.com/lists/?p=preferences&uid=## (##...mysite.com/lists/?p=preferences&uid=41f0e3d602a3d253498...## in this example).
~This feature must be enabled by the site administrator. If enabled, each user can choose his/her personal password to modify his/her personal file in the preferences pages. ''how does this work? is it encrypted?''
%%[checkbox] list one
[checkbox] list two
**IMPORTANT**: **to save any changes** made to the user's details and mailinglist memberships, you must **click on #%save changes#%**.
Deletions:
What is a user?
a user's file: what is it, how to work with it, etc.
public/private attributes
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;????;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;never used... please explain!;Country; [pulldown menu]; One example of attribute. All the other attributes are listed here and below"}}
~''Explain what it means to be confirmed''
~''explain what this means''
~''explain what a bounced message is, what this means.''
~''explain how this is used by phplist (confirmationURL, prefs, etc.) ''
~''how does this work? is it encrypted?''
%%[checkbox] test
[checkbox] list 2
**IMPORTANT**: to save any changes made to the user's details and mailinglist memberships, you must **click on [save changes]**.

Revision [144]

Edited on 2005-03-16 18:26:48 by YanB
Additions:
===== User File: documentation =====
==== Description ====
##**back to the list of users**##
##**back to the search results**##
##**Delete will delete user from the list**##
~''from what list? ? This must be an ERROR, and should read: this will delete the user from the database, no?''
~{{table columns="5" cells="delete; john@web.com ;  update page ; unsubscribe page ; history"}}
##**delete**##
~''see remark above''
##**update page**##
##**unsubscribe page**##
##**history**##
~To view a history of all the changes made to this user's file, including the list of messages this user received. See [[UserHistoryInfo user's history]] for more.
=== User details ===
~Note: Descriptions marked with * have additional remarks below.
{{table columns="3" cells="Attribute;Data (Example);DESCRIPTION; ID;1;Each user is given a unique ID number by PHPlist; Email;john@web.com;Only one email can be entered in this field; Is this user confirmed (1/0);1;1=yes, 0=no * ; Is this user blacklisted;0;1=yes, 0=no * ; Number of bounces on this user;0;Total number of bounced messages for this user * ; Entered;2005-03-05 13:57:59;Date/time when the user first subscribed to any list;Last Modified;20050306123000;Date/time when the user last modified his/her details;Unique ID for User;41f0e3d602a3d253498...;PHPlist attributes a unique ID to each user * ;Send this user HTML emails;0;1=yes, 0=no;Which page was used to subscribe;????;Useful when there are several subscribe pages;RSS Frequency;weekly;Several options are possible: (empty)/daily/weekly/monthly * ;Password;;The user's password (this feature must be enabled by the site administrator) * ;Last time password was changed;;self-explanatory;Is this account disabled?;0;1=yes, 0=no;Additional data;;?????;Foreign Key;;never used... please explain!;Country; [pulldown menu]; One example of attribute. All the other attributes are listed here and below"}}
##**Is this user confirmed (1/0)**##
~''Explain what it means to be confirmed''
##**Is this user blacklisted**##
~''explain what this means''
##**Number of bounces on this user**##
~''explain what a bounced message is, what this means.''
##**Unique ID for User**##
~''explain how this is used by phplist (confirmationURL, prefs, etc.) ''
##**RSS Frequency**##
~This feature must be enabled by the site administrator. See [[RssFunctionsInfo RSS]] for more.
##**Password**##
~''how does this work? is it encrypted?''
=== Mailinglist membership ===
Example:
%%[checkbox] test
[checkbox] list 2
[save changes]%%
~Note: Only the lists which the administrator owns are displayed here. The administrator can check/uncheck the user from any of the available lists.
**IMPORTANT**: to save any changes made to the user's details and mailinglist memberships, you must **click on [save changes]**.
**Related pages:**
~-[[ListListsInfo Lists]]
~-[[UserHistoryInfo User History]]
~-[[ConfigureSubscribePageInfo Subscribe Page]]
Deletions:
===== User file: documentation =====

Revision [142]

Edited on 2005-03-16 15:24:27 by YanB
Additions:
===== User file: documentation =====

What is a user?

a user's file: what is it, how to work with it, etc.
public/private attributes
Deletions:
=====Title of the page =====
//This page is a **template** intended for documentation of **official phplist features**. This page belongs to CategoryTemplate (which contains more handy templates). To create a phplist **documentation** page, [[http://docs.phplist.com/DocumentationTemplate/clone clone this page]], replace the title with a meaningful one and replace this paragraph with the actual page content.//

Revision [141]

The oldest known version of this page was created on 2005-03-16 15:23:16 by YanB [Cloned from DocumentationTemplate]
Page was generated in 0.0364 seconds