# export_emails

synopsis

  export the email addresses for your users in one of many formats

Most Django sites include a registered user base. There are times when you would like to import these e-mail addresses into other systems (generic mail program, Gmail, Google Docs invites, give edit permissions, LinkedIn Group pre-approved listing, etc.). The export_emails command extension gives you this ability. Exported users can be filtered by Group name association.

## Example Usage

    # Export all the addresses in the '"First Last" <my@addr.com>;' format.
    $ ./manage.py export_emails > addresses.txt

    # Export users from the group 'Attendees' in the linked in pre-approve Group csv format.
    $ ./manage.py export_emails -g Attendees -f linkedin pycon08.csv

    # Create a csv file importable by Gmail or Google Docs
    $ ./manage.py export_emails --format=google google.csv

## Supported Formats

### address

This is the default basic text format. Each entry is on its own line in the format:

    "First Last" <user@host.com>;

This can be used with all known mail programs (that I know about anyway).

### google

A CSV (comma separated value) format which Google applications can import. This can be used to import directly into Gmail, a Gmail mailing group, Google Docs invite (to read), Google Docs grant edit permissions, Google Calendar invites, etc.

Only two columns are supplied. One for the person’s name and one for the email address. This is also nice for importing into spreadsheets.

### outlook

A CSV (comma separated value) format which Outlook can parse and import. Supplies all the columns that Outlook ‘requires’, but only the name and email address are supplied.

### linkedin

A CSV (comma separated value) format which can be imported by LinkedIn Groups to pre-approve a list of people for joining the group.

This supplies 3 columns: first name, last name, and email address. This is the best generic csv file for importing into spreadsheets as well.

### vcard

A vCard format which Apple Address Book can parse and import.

## Settings

There are a couple of settings keys which can be configured in settings.py. Below the default values are shown:

    EXPORT_EMAILS_ORDER_BY = ['last_name', 'first_name', 'username', 'email']
    EXPORT_EMAILS_FIELDS = ['last_name', 'first_name', 'username', 'email']
    EXPORT_EMAILS_FULL_NAME_FUNC = None

### EXPORT_EMAILS_ORDER_BY

Specifies the order_by(…) clause on the query being done into the database to retrieve the users. This determines the order of the output.

### EXPORT_EMAILS_FIELDS

Specifies which fields will be selected from the database. This is most useful in combination with EXPORT_EMAILS_FULL_NAME_FUNC to select other fields you might want to use inside the custom function or when using a custom User model which does not have fields like ‘first_name’ and ‘last_name’.

### EXPORT_EMAILS_FULL_NAME_FUNC

A function to use to create a full name based on the database fields selected by EXPORT_EMAILS_FULL_NAME_FUNC. The default implementation can be looked up in https://github.com/django-extensions/django-extensions/blob/master/django_extensions/management/commands/export_emails.py#L23