Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
cubicweb
cubes
person
Commits
705501994c41
Commit
8e32d6af
authored
Jul 08, 2010
by
Sylvain Thénault
Browse files
missing readme file
parent
f40113b147e7
Changes
1
Hide whitespace changes
Inline
Side-by-side
README
0 → 100644
View file @
70550199
Summary
-------
`person` provides person informations :
- firstname
- surname / lastname
- civility
- arbitrary text description
- a relation to an email address (NB, the `EmailAddress` entity is
automatically provided by cubicweb).
If the `addressbook` cube is used, persons will also have *phone* and
*postal_address* relations to store more contact information.
There is a special relation called 'primary_email'. A person can be linked to
multiple email addresses (using the 'use_email' relation). The primary email
must be unique. At the creation of the first email, this relation is
automatically added (though you can change it later, of course).
Recommends
----------
- `addressbook` cube
Usage
-----
In addition of basic entity views, this cube provides :
- *VCardPersonView*, displays a person in the VCard file format
(.. _VCard on wikipedia: http://en.wikipedia.org/wiki/VCard) .
This view creates a file called `vcard.vcf` which can be open in
your addressbook application (Kmail, Thunderbird and so on). In
order to generate this file, you have to access to a specific view
using an url address with `?vid=vcard` suffix.
How to personalize the person primary view in order to add a link
for the vcard ?
.. sourcecode:: python
class PersonalizedPersonPrimaryView(PersonPrimaryView):
def render_entity_attributes(self, entity):
super(PersonalizedPersonPrimaryView, self).render_entity_attributes(entity)
self.w(u'<div><a href="%s">export contact as vcard</a></div>' % entity.absolute_url(vid='vcard'))
This view will not be selected by default. You have to registered
this view or add a selector. For more information, please refer to
XXX in the doc.
- a *civility facet*, this facet (XXX: ref to facet doc) will be shown
if a view displays a result set of at least two Person entities with
different civilities.
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment