Forums / Developer / Enabling, Configuring and Using personlist ...

Enabling, Configuring and Using personlist ...

Author Message

kracker (the)

Tuesday 28 June 2005 3:47:03 am

Greetings,

I am trying to use the personlist contribution.

I'm trying configure the extension. I have followed the basic instructions provided,
yet I can't seem to tell just how I would know if I have properly enabled the extension?

I don't notice any installed classes, extra menus, features, screens, nothing.

I have (really) properly enabled the extension via the override/site.ini.append.php & cleared all caches thoroughly.

I'm wondering if anyone else has used this extension with success?

<i>http://ez.no/community/contribs/datatypes/personlist_datatype</i>

Any extra hints, tips or suggestions for someone trying to use the personlist extension to send emails to registered users emails when new or updated articles are published?

//kracker
<i>film : sin city</i>

Member since: 2001.07.13 || http://ezpedia.se7enx.com/

Paul Borgermans

Tuesday 28 June 2005 5:02:13 am

Kracker

You bet it works: we use it here a lot (its from us :-))

You should notice at least a new datatype which offers some possibilities depending on personlist.ini settings.

Can you post yours?

-paul

eZ Publish, eZ Find, Solr expert consulting and training
http://twitter.com/paulborgermans

kracker (the)

Tuesday 28 June 2005 5:34:50 am

Sure :)

I respect that it does work. I do have problems with with the limited documentation explaining how it works and how to use it as being a barrier to entry of using it.

<i>settings/override/personlist.ini.append.php</i>

[GeneralSettings]
# HasPrimaryPerson is an array of class identifiers where people should select a
# primary person in the list of persons
# This can be used for instance to identify the primary author in an author list
# Defaults to none. If set, a radio button will appear to select the primary person,
# which also defaults to the first person in the list
# Syntax: HasPrimaryPerson[]=<class_identifier>
HasPrimaryPerson[]
# HasPrimaryPerson[]=

[EnableEmailDistribution]
# EnabledList is an array of class identifiers that should send out emails
# Syntax: EnabledList[]=<class_identifier>
EnabledList[]
EnabledList[]=kbs
EnabledList[]=article
EnabledList[]=file
EnabledList[]=file_extended

[UserInfoSettings]
# Associative array: key = class identifier; value = attribute identifier
# Defines the attribute of a class that contains the user id the datatype should store
# Special value: 'object_id' to use the object's ID. This is also default if a selected userclass is not configured here
# Syntax: UserID[<class_identifier>]=<attribute_identifier>
# example (for normal installations)
# UserID[user]=object_id
UserID[]
UserID[user]=user_id

# Specifies the attribute identifier(s) that define the name of a user.
# Syntax: UserName[<class_identifier>]=<attribute_identifier>
# Same syntax for UserFirstName
# UserName[user]=last_name
# UserFirstNAme[user]=first_name
UserName[user]=last_name
UserFirstName[user]=first_name

//kracker
<i>south park : school 23</i>

Member since: 2001.07.13 || http://ezpedia.se7enx.com/

Paul Borgermans

Tuesday 28 June 2005 7:11:46 am

Hi Kracker

Try to use

UserID[user]=object_id

It's use with an attribute is only of importance when using foreign user id which gets imported for example from an LDAP server (which we do).

Does this help?

-paul

eZ Publish, eZ Find, Solr expert consulting and training
http://twitter.com/paulborgermans

kracker (the)

Tuesday 28 June 2005 8:52:43 am

Alrighty,

I'm only trying use basic ez publish registered users.

I switched to using: UserID[user]=object_id
Saved, cleared all cache...

Another part I'm still a bit unclear about is do I add the personlist datatype to the classes I want to email users when they change or the user class?

I first tried to add the personlist datatype to the article class, which seems like the right ...

I was a bit confused by the ' Users' Node: ' Option in the datatype attribute as it did not display an feedback that it had in fact show the user node i had selected.

Another point of confusion was the 'User classes:' which I set to be the standard user class.

I cleared all caches and edited an article object, but while I saw the new personlist attribute, I didn't see any users (from the group I selected) in the available list... should I have?

Do I have to manually input all users to receive notifications or more specifically how can I email all the already registered users without having to add them all by hand?

//kracker
<i>man's best friend : ode to clean air</i>

Member since: 2001.07.13 || http://ezpedia.se7enx.com/

Paul Borgermans

Tuesday 28 June 2005 9:21:28 am

Hi Kracker

You are almost there:

<i>I switched to using: UserID[user]=object_id
Saved, cleared all cache...<i>

Good

<i>Another part I'm still a bit unclear about is do I add the personlist datatype to the classes I want to email users when they change or the user class?</i>
<i>
I first tried to add the personlist datatype to the article class, which seems like the right ...</i>

Yes, add it to the classes for which you want this

<i>I was a bit confused by the ' Users' Node: ' Option in the datatype attribute as it did not display an feedback that it had in fact show the user node i had selected.</i>

Good point, marked as feature to add

<i>
Another point of confusion was the 'User classes:' which I set to be the standard user class.
</i>

Yes, but you can have more than one user class in ez publish, not often used I guess..

<i>
I cleared all caches and edited an article object, but while I saw the new personlist attribute, I didn't see any users (from the group I selected) in the available list... should I have?
</i>

You should have users in the drop select box. there you should be able to select one or more at the same time

<i>
Do I have to manually input all users to receive notifications</i>

Yes

<i> or more specifically how can I email all the already registered users without having to add them all by hand?
</i>

I use a dummy object for that kind of actions with an override template which lists a nice table to copy paste into an email client for bulk emails.

hth

-paul

eZ Publish, eZ Find, Solr expert consulting and training
http://twitter.com/paulborgermans

kracker (the)

Tuesday 28 June 2005 9:59:21 am

Thank you for your great answers, I hope all of this helps others try/use this extension...

Most the answers don't come as a shock only confirmation of a few things I was unsure about. Ok, so I got it partly working as desired ...(I think)

It seems to be mailing the user administrators of changes but not the user node I selected though...and not the users I manually have added to the list while editing / updating an article.

<i>> I cleared all caches and edited an article object, but while I saw the new personlist attribute, I didn't see any users (from the group I selected) in the available list... should I have?</i>

<i>>>You should have users in the drop select box. there you should be able to select one or more at the same time</i>

Sorry, I can't seem to get any list of users into that select list/box...
I'm wondering just what steps are a dependency for this part of it's usage...

<i>> or more specifically how can I email all the already registered users without having to add them all by hand?</i>

<i>>>I use a dummy object for that kind of actions with an override template which lists a nice table to copy paste into an email client for bulk emails.</i>

Can you elaborate on your last point? Is this a custom solution not in the extension? If this is something you have created that is not in the extension, would you consider adding it?

I'm not entirely clear on what you mean by using a dummy object/template list...

I see a table for selecting users in the edit screen of an article, around the notification list the 'Internal notification list' multi option list and the 'External notification list' user list ..

I have selected the 'E-mail this person' for a user that I have added successfully/manually to the top notification table list but the user doesn't seem to get any makes but the admin user (same email server as manually added user) does get the mails.

I keep thinking that the 'Internal notification list' would display all the users in the user group / node I selected in the datatype attribute editing of the class :?

Again, I am trying to use the module because I thought I could use it to email existing registered users of updated/ new content...without having to build/maintain another list of users.

respectfully,
//kracker

Member since: 2001.07.13 || http://ezpedia.se7enx.com/

Filippo Ferrari

Wednesday 02 November 2005 2:56:33 am

I am trying to use the personlist contribution too, but I've the same problem. I can't see any user in the dropdown menu "internal newsletter".

I've created a copy of the article class named newsletter with one more attribute, the personlist datatype,

This is my ini:

[GeneralSettings]
# HasPrimaryPerson is an array of class identifiers where people should select a
# primary person in the list of persons
# This can be used for instance to identify the primary author in an author list
# Defaults to none. If set, a radio button will appear to select the primary person,
# which also defaults to the first person in the list
# Syntax: HasPrimaryPerson[]=<class_identifier>
HasPrimaryPerson[]
# HasPrimaryPerson[]=

[EnableEmailDistribution]
# EnabledList is an array of class identifiers that should send out emails
# Syntax: EnabledList[]=<class_identifier>
EnabledList[]
EnabledList[]=newsletter

[UserInfoSettings]
# Associative array: key = class identifier; value = attribute identifier
# Defines the attribute of a class that contains the user id the datatype should store
# Special value: 'object_id' to use the object's ID. This is also default if a selected userclass is not configured here
# Syntax: UserID[<class_identifier>]=<attribute_identifier>
# example (for normal installations)
# UserID[user]=object_id
UserID[]
UserID[user]=object_id

# Specifies the attribute identifier(s) that define the name of a user.
# Syntax: UserName[<class_identifier>]=<attribute_identifier>
# Same syntax for UserFirstName
# UserName[user]=last_name
# UserFirstNAme[user]=first_name
UserName[user]=last_name

I've choose users in user's node attribute of personlist datatype

And user as users class

But still doesn't work...????