==[[PhplistDocumentation Phplist Documentation]] » [[ListAndUserFunctionsInfo List and User functions]] » [[ListUsersInfo Users]] » [[UserInfo User file]] » ==
----
===== User History =====


This page allows you to view a **history of all the changes** made to a [[UserInfo user]]'s personal file, including the list of [[ListMessagesInfo messages]] this user received. The information recorded is:
~-which **messages** were sent to the user, and which messages bounced
~-the **changes** made to the user's file data and list subscriptions (if any)
~-information on **who changed** the user file (i.e. the user or an admin), with IP address, browser and OS used by the person who changed the file, etc. This tracking feature provides enhanced security.

This page is also used when you wish to **remove a user from the blacklist**.


====Description====

**##User john@mail.com##**
~The email of the user (//john@mail.com// in this example)

**##2 messages sent to this user##**
~The number of messages sent to this user (//2// in this example)

{{table columns="3" cells="Messages;sent;bounce;616; Sat May 6 12:40 CEST 2004;;602;Wed March 2 13:40 CEST 2004;"}}
**##Messages##**
~The ID corresponding to the message that was sent. Each message has a unique ID (//616// and //602// in this example). For more, see [[SendMessageInfo send message]].
**##sent##**
~The date and time at which the message was sent.
**##bounce##**
~If a message bounced, the information appears here. ''in what form? date/time? ?''

===User Subscription History===
~//Example with 2 entries. Definitions of what each entry means is detailed below.//

{{table columns="4" cells="Subscription History;ip;date;summary;274;24.24.224.24;2005-02-26 21:25:36;Change"}}
**##detail##**
~##City = Greaseville##
~**##*changed* from##** ##Lightville##
~**##List subscriptions:##**
~**##Was subscribed to:##** ##listname 2##
~**##Was subscribed to:##** ##listname 3##
~**##Is now subscribed to:##** ##listname 1##
~**##Is now subscribed to:##** ##listname 2##

**##info##**
~**##HTTP_USER_AGENT##** ##= Mozilla/5.0...##
~**##HTTP_REFERER##** ##= ""http://www.mysite.com/lists/?p=preferences&uid=ba7fdc88356""...##
~**##REMOTE_ADDR##** ##= 24.24.224.24##
----
{{table columns="4" cells="Subscription History;ip;date;summary;54;13.13.113.13;2001-01-12 12:45:11;Update by adminname"}}
**##detail##**
~**##No user system details changed##** or **##No userdata changed##**
~**##List Membership:##**
~~##* listname 1##
~~##* listname 2##

**##info##**
~**##HTTP_USER_AGENT##** =## Netscape/7.1...##
~**##HTTP_REFERER##** ##= ""http://www.mysite.com/lists/admin/?page=user&start=&id=12""...##
~**##REMOTE_ADDR##** ##= 13.13.113.13##
----

===Definitions===

**##Subscription History##**
~Each change made to a user's file is recorded with a unique ID which appears here for reference.
**##ip##**
~IP address of the person who made a change to the user's file.
**##date##**
~Date and time at which the change was made.
**##summary##**
~This briefly defines what type of change was made to the user's file:
~-##Change##
~~the change was made using the public 'preferences' page. This usually means that it is the user him/herself who made the changes.
~-##Update by adminname##
~~the change was made by an admin (admin //##adminname##// in this example).
~-##Confirmation##
~~the day/date when the user confirms his/her subscription. Each user has to confirm his/her subscription to your system by clicking on the confirmationURL sent in the confirmation email ''see .. add link to docs''.
~-##Subscription##
~~the day/date when the user subscribed to your system. All the information entered upon subscription is detailed here. Details include the ID of the [[SubscribePageInfo subscribe page]] which was used.

**##detail##**
~All the changes concerning the user's details are found here, including which lists the user was (un)subscribed to. If no changes are made, this is mentioned too.
~Only the data which was changed is listed here, listed by attributes, with the new and old values for each attribute listed in the order in which they appear on the subscribe page.
''Question: it seems that regardless of any changes in the lists, they are all listed again here. is this correct?''

**##HTTP_USER_AGENT##**
~Details on the browser and operating system used by the person who made the changes to the user's file.
**##HTTP_REFERER##**
~Page from which the change was made. This enables to verify whether the change was made using a public page (preferences page) or a private page (admin pages). See examples above for an illustration (the first is a public page, the second is an admin page).
**##REMOTE_ADDR##**
~IP address of the person who made a change to the user's file.


**Related pages:**
~-[[UserInfo User File]]
~-[[ListListsInfo Lists]]

----
CategoryDocumentation