array(
'label' => t('Profile'),
'plural label' => t('Profiles'),
'description' => t('Profile2 user profiles.'),
'entity class' => 'Profile',
'controller class' => 'EntityAPIController',
'base table' => 'profile',
'fieldable' => TRUE,
'view modes' => array(
'account' => array(
'label' => t('User account'),
'custom settings' => FALSE,
),
),
'entity keys' => array(
'id' => 'pid',
'bundle' => 'type',
'label' => 'label',
),
'bundles' => array(),
'bundle keys' => array(
'bundle' => 'type',
),
'label callback' => 'entity_class_label',
'uri callback' => 'entity_class_uri',
'access callback' => 'profile2_access',
'module' => 'profile2',
'metadata controller class' => 'Profile2MetadataController'
),
);
// Add bundle info but bypass entity_load() as we cannot use it here.
$types = db_select('profile_type', 'p')
->fields('p')
->execute()
->fetchAllAssoc('type');
foreach ($types as $type => $info) {
$return['profile2']['bundles'][$type] = array(
'label' => $info->label,
'admin' => array(
'path' => 'admin/structure/profiles/manage/%profile2_type',
'real path' => 'admin/structure/profiles/manage/' . $type,
'bundle argument' => 4,
'access arguments' => array('administer profiles'),
),
);
}
// Support entity cache module.
if (module_exists('entitycache')) {
$return['profile2']['field cache'] = FALSE;
$return['profile2']['entity cache'] = TRUE;
}
$return['profile2_type'] = array(
'label' => t('Profile type'),
'plural label' => t('Profile types'),
'description' => t('Profiles types of Profile2 user profiles.'),
'entity class' => 'ProfileType',
'controller class' => 'EntityAPIControllerExportable',
'base table' => 'profile_type',
'fieldable' => FALSE,
'bundle of' => 'profile2',
'exportable' => TRUE,
'entity keys' => array(
'id' => 'id',
'name' => 'type',
'label' => 'label',
),
'access callback' => 'profile2_type_access',
'module' => 'profile2',
// Enable the entity API's admin UI.
'admin ui' => array(
'path' => 'admin/structure/profiles',
'file' => 'profile2.admin.inc',
'controller class' => 'Profile2TypeUIController',
),
);
return $return;
}
/**
* Menu argument loader; Load a profile type by string.
*
* @param $type
* The machine-readable name of a profile type to load.
* @return
* A profile type array or FALSE if $type does not exist.
*/
function profile2_type_load($type) {
return profile2_get_types($type);
}
/**
* Implements hook_permission().
*/
function profile2_permission() {
$permissions = array(
'administer profile types' => array(
'title' => t('Administer profile types'),
'description' => t('Create and delete fields on user profiles, and set their permissions.'),
),
'administer profiles' => array(
'title' => t('Administer profiles'),
'description' => t('Edit and view all user profiles.'),
),
);
// Generate per profile type permissions.
foreach (profile2_get_types() as $type) {
$type_name = check_plain($type->type);
$permissions += array(
"edit own $type_name profile" => array(
'title' => t('%type_name: Edit own profile', array('%type_name' => $type->getTranslation('label'))),
),
"edit any $type_name profile" => array(
'title' => t('%type_name: Edit any profile', array('%type_name' => $type->getTranslation('label'))),
),
"view own $type_name profile" => array(
'title' => t('%type_name: View own profile', array('%type_name' => $type->getTranslation('label'))),
),
"view any $type_name profile" => array(
'title' => t('%type_name: View any profile', array('%type_name' => $type->getTranslation('label'))),
),
);
}
return $permissions;
}
/**
* Gets an array of all profile types, keyed by the type name.
*
* @param $type_name
* If set, the type with the given name is returned.
* @return ProfileType[]
* Depending whether $type isset, an array of profile types or a single one.
*/
function profile2_get_types($type_name = NULL) {
$types = entity_load_multiple_by_name('profile2_type', isset($type_name) ? array($type_name) : FALSE);
return isset($type_name) ? reset($types) : $types;
}
/**
* Fetch a profile object.
*
* @param $pid
* Integer specifying the profile id.
* @param $reset
* A boolean indicating that the internal cache should be reset.
* @return
* A fully-loaded $profile object or FALSE if it cannot be loaded.
*
* @see profile2_load_multiple()
*/
function profile2_load($pid, $reset = FALSE) {
$profiles = profile2_load_multiple(array($pid), array(), $reset);
return reset($profiles);
}
/**
* Load multiple profiles based on certain conditions.
*
* @param $pids
* An array of profile IDs.
* @param $conditions
* An array of conditions to match against the {profile} table.
* @param $reset
* A boolean indicating that the internal cache should be reset.
* @return
* An array of profile objects, indexed by pid.
*
* @see entity_load()
* @see profile2_load()
* @see profile2_load_by_user()
*/
function profile2_load_multiple($pids = array(), $conditions = array(), $reset = FALSE) {
return entity_load('profile2', $pids, $conditions, $reset);
}
/**
* Fetch profiles by account.
*
* @param $account
* The user account to load profiles for, or its uid.
* @param $type_name
* To load a single profile, pass the type name of the profile to load.
* @return
* Either a single profile or an array of profiles keyed by profile type.
*
* @see profile2_load_multiple()
* @see profile2_profile2_delete()
* @see Profile::save()
*/
function profile2_load_by_user($account, $type_name = NULL) {
// Use a separate query to determine all profile ids per user and cache them.
// That way we can look up profiles by id and benefit from the static cache
// of the entity loader.
$cache = &drupal_static(__FUNCTION__, array());
$uid = is_object($account) ? $account->uid : $account;
if (!isset($cache[$uid])) {
if (empty($type_name)) {
$profiles = profile2_load_multiple(FALSE, array('uid' => $uid));
// Cache ids for further lookups.
$cache[$uid] = array();
foreach ($profiles as $pid => $profile) {
$cache[$uid][$profile->type] = $pid;
}
return $profiles ? array_combine(array_keys($cache[$uid]), $profiles) : array();
}
$cache[$uid] = db_select('profile', 'p')
->fields('p', array('type', 'pid'))
->condition('uid', $uid)
->execute()
->fetchAllKeyed();
}
if (isset($type_name)) {
return isset($cache[$uid][$type_name]) ? profile2_load($cache[$uid][$type_name]) : FALSE;
}
// Return an array containing profiles keyed by profile type.
return $cache[$uid] ? array_combine(array_keys($cache[$uid]), profile2_load_multiple($cache[$uid])) : $cache[$uid];
}
/**
* Implements hook_profile2_delete().
*/
function profile2_profile2_delete($profile) {
// Clear the static cache from profile2_load_by_user().
$cache = &drupal_static('profile2_load_by_user', array());
unset($cache[$profile->uid][$profile->type]);
}
/**
* Deletes a profile.
*/
function profile2_delete(Profile $profile) {
$profile->delete();
}
/**
* Delete multiple profiles.
*
* @param $pids
* An array of profile IDs.
*/
function profile2_delete_multiple(array $pids) {
entity_get_controller('profile2')->delete($pids);
}
/**
* Implements hook_user_delete().
*/
function profile2_user_delete($account) {
foreach (profile2_load_by_user($account) as $profile) {
profile2_delete($profile);
}
}
/**
* Create a new profile object.
*/
function profile2_create(array $values) {
return new Profile($values);
}
/**
* Deprecated. Use profile2_create().
*/
function profile_create(array $values) {
return new Profile($values);
}
/**
* Saves a profile to the database.
*
* @param $profile
* The profile object.
*/
function profile2_save(Profile $profile) {
return $profile->save();
}
/**
* Saves a profile type to the db.
*/
function profile2_type_save(ProfileType $type) {
$type->save();
}
/**
* Deletes a profile type from.
*/
function profile2_type_delete(ProfileType $type) {
$type->delete();
}
/**
* Implements hook_profile2_type_delete()
*/
function profile2_profile2_type_delete(ProfileType $type) {
// Delete all profiles of this type but only if this is not a revert.
if (!$type->hasStatus(ENTITY_IN_CODE)) {
$pids = array_keys(profile2_load_multiple(FALSE, array('type' => $type->type)));
if ($pids) {
profile2_delete_multiple($pids);
}
}
}
/**
* Implements hook_user_view().
*/
function profile2_user_view($account, $view_mode, $langcode) {
foreach (profile2_get_types() as $type => $profile_type) {
if ($profile_type->userView && $profile = profile2_load_by_user($account, $type)) {
if (profile2_access('view', $profile)) {
$account->content['profile_' . $type] = array(
'#type' => 'user_profile_category',
'#title' => t($profile->label),
'#prefix' => '',
);
$account->content['profile_' . $type]['view'] = $profile->view('account');
}
}
}
}
/**
* Implements hook_form_FORM_ID_alter() for the user edit form.
*
* @see profile2_form_validate_handler
* @see profile2_form_submit_handler
*/
function profile2_form_user_profile_form_alter(&$form, &$form_state) {
if (($type = profile2_get_types($form['#user_category'])) && $type->userCategory) {
if (empty($form_state['profiles'])) {
$profile = profile2_load_by_user($form['#user'], $form['#user_category']);
if (empty($profile)) {
$profile = profile2_create(array('type' => $form['#user_category'], 'uid' => $form['#user']->uid));
}
$form_state['profiles'][$profile->type] = $profile;
}
profile2_attach_form($form, $form_state);
}
}
/**
* Implements hook_form_FORM_ID_alter() for the registration form.
*/
function profile2_form_user_register_form_alter(&$form, &$form_state) {
foreach (profile2_get_types() as $type_name => $profile_type) {
if (!empty($profile_type->data['registration'])) {
if (empty($form_state['profiles'][$type_name])) {
$form_state['profiles'][$type_name] = profile2_create(array('type' => $type_name));
}
profile2_attach_form($form, $form_state);
// Wrap each profile form in a fieldset.
$form['profile_' . $type_name] += array(
'#type' => 'fieldset',
'#title' => check_plain($profile_type->getTranslation('label')),
);
}
}
}
/**
* Attaches the profile forms of the profiles set in
* $form_state['profiles'].
*
* Modules may alter the profile2 entity form regardless to which form it is
* attached by making use of hook_form_profile2_form_alter().
*
* @param $form
* The form to which to attach the profile2 form. For each profile the form
* is added to @code $form['profile_' . $profile->type] @endcode. This helper
* also adds in a validation and a submit handler caring for the attached
* profile forms.
*
* @see hook_form_profile2_form_alter()
* @see profile2_form_validate_handler()
* @see profile2_form_submit_handler()
*/
function profile2_attach_form(&$form, &$form_state) {
foreach ($form_state['profiles'] as $type => $profile) {
$form['profile_' . $profile->type]['#tree'] = TRUE;
$form['profile_' . $profile->type]['#parents'] = array('profile_' . $profile->type);
field_attach_form('profile2', $profile, $form['profile_' . $profile->type], $form_state);
if (count(field_info_instances('profile2', $profile->type)) == 0) {
$form['profile_' . $profile->type]['message'] = array(
'#access' => user_access('administer profile types'),
'#markup' => t('No fields have been associated with this profile type. Go to the Profile types page to add some fields.', array('!url' => url('admin/structure/profiles'))),
);
}
// Provide a central place for modules to alter the profile forms, but
// skip that in case the caller cares about invoking the hooks.
// @see profile2_form().
if (!isset($form_state['profile2_skip_hook'])) {
$hooks[] = 'form_profile2_edit_' . $type . '_form';
$hooks[] = 'form_profile2_form';
drupal_alter($hooks, $form, $form_state);
}
}
$form['#validate'][] = 'profile2_form_validate_handler';
$form['#submit'][] = 'profile2_form_submit_handler';
}
/**
* Validation handler for the profile form.
*
* @see profile2_attach_form()
*/
function profile2_form_validate_handler(&$form, &$form_state) {
foreach ($form_state['profiles'] as $type => $profile) {
if (isset($form_state['values']['profile_' . $profile->type])) {
// @see entity_form_field_validate()
$pseudo_entity = (object) $form_state['values']['profile_' . $profile->type];
$pseudo_entity->type = $type;
field_attach_form_validate('profile2', $pseudo_entity, $form['profile_' . $profile->type], $form_state);
}
}
}
/**
* Submit handler that builds and saves all profiles in the form.
*
* @see profile2_attach_form()
*/
function profile2_form_submit_handler(&$form, &$form_state) {
profile2_form_submit_build_profile($form, $form_state);
// This is needed as some submit callbacks like user_register_submit() rely on
// clean form values.
profile2_form_submit_cleanup($form, $form_state);
foreach ($form_state['profiles'] as $type => $profile) {
// During registration set the uid field of the newly created user.
if (empty($profile->uid) && isset($form_state['user']->uid)) {
$profile->uid = $form_state['user']->uid;
}
profile2_save($profile);
}
}
/**
* Submit builder. Extracts the form values and updates the profile entities.
*
* @see profile2_attach_form()
*/
function profile2_form_submit_build_profile(&$form, &$form_state) {
foreach ($form_state['profiles'] as $type => $profile) {
// @see entity_form_submit_build_entity()
if (isset($form['profile_' . $type]['#entity_builders'])) {
foreach ($form['profile_' . $type]['#entity_builders'] as $function) {
$function('profile2', $profile, $form['profile_' . $type], $form_state);
}
}
field_attach_submit('profile2', $profile, $form['profile_' . $type], $form_state);
}
}
/**
* Cleans up the form values as the user modules relies on clean values.
*
* @see profile2_attach_form()
*/
function profile2_form_submit_cleanup(&$form, &$form_state) {
foreach ($form_state['profiles'] as $type => $profile) {
unset($form_state['values']['profile_' . $type]);
}
}
/**
* Implements hook_user_categories().
*/
function profile2_user_categories() {
$data = array();
foreach (profile2_get_types() as $type => $info) {
if ($info->userCategory) {
$data[] = array(
'name' => $type,
'title' => $info->getTranslation('label'),
// Add an offset so a weight of 0 appears right of the account category.
'weight' => $info->weight + 3,
'access callback' => 'profile2_category_access',
'access arguments' => array(1, $type)
);
}
}
return $data;
}
/**
* Menu item access callback - check if a user has access to a profile category.
*/
function profile2_category_access($account, $type_name) {
// As there might be no profile yet, create a new object for being able to run
// a proper access check.
$profile = profile2_create(array('type' => $type_name, 'uid' => $account->uid));
return ($account->uid > 0 && $profile->type()->userCategory && profile2_access('edit', $profile));
}
/**
* Determines whether the given user has access to a profile.
*
* @param $op
* The operation being performed. One of 'view', 'update', 'create', 'delete'
* or just 'edit' (being the same as 'create' or 'update').
* @param $profile
* (optional) A profile to check access for. If nothing is given, access for
* all profiles is determined.
* @param $account
* The user to check for. Leave it to NULL to check for the global user.
* @return boolean
* Whether access is allowed or not.
*
* @see hook_profile2_access()
* @see profile2_profile2_access()
*/
function profile2_access($op, $profile = NULL, $account = NULL) {
if (user_access('administer profiles', $account)) {
return TRUE;
}
if ($op == 'create' || $op == 'update') {
$op = 'edit';
}
// Allow modules to grant / deny access.
$access = module_invoke_all('profile2_access', $op, $profile, $account);
// Only grant access if at least one module granted access and no one denied
// access.
if (in_array(FALSE, $access, TRUE)) {
return FALSE;
}
elseif (in_array(TRUE, $access, TRUE)) {
return TRUE;
}
return FALSE;
}
/**
* Implements hook_profile2_access().
*/
function profile2_profile2_access($op, $profile = NULL, $account = NULL) {
// Don't grant access for users to delete their profile.
if (isset($profile) && ($type_name = $profile->type) && $op != 'delete') {
if (user_access("$op any $type_name profile", $account)) {
return TRUE;
}
$account = isset($account) ? $account : $GLOBALS['user'];
if (isset($profile->uid) && $profile->uid == $account->uid && user_access("$op own $type_name profile", $account)) {
return TRUE;
}
}
// Do not explicitly deny access so others may still grant access.
}
/**
* Access callback for the entity API.
*/
function profile2_type_access($op, $type = NULL, $account = NULL) {
return user_access('administer profile types', $account);
}
/**
* Implements hook_theme().
*/
function profile2_theme() {
return array(
'profile2' => array(
'render element' => 'elements',
'template' => 'profile2',
),
);
}
/**
* The class used for profile entities.
*/
class Profile extends Entity {
/**
* The profile id.
*
* @var integer
*/
public $pid;
/**
* The name of the profile type.
*
* @var string
*/
public $type;
/**
* The profile label.
*
* @var string
*/
public $label;
/**
* The user id of the profile owner.
*
* @var integer
*/
public $uid;
/**
* The Unix timestamp when the profile was created.
*
* @var integer
*/
public $created;
/**
* The Unix timestamp when the profile was most recently saved.
*
* @var integer
*/
public $changed;
public function __construct($values = array()) {
if (isset($values['user'])) {
$this->setUser($values['user']);
unset($values['user']);
}
if (isset($values['type']) && is_object($values['type'])) {
$values['type'] = $values['type']->type;
}
if (!isset($values['label']) && isset($values['type']) && $type = profile2_get_types($values['type'])) {
// Initialize the label with the type label, so newly created profiles
// have that as interim label.
$values['label'] = $type->label;
}
parent::__construct($values, 'profile2');
}
/**
* Returns the user owning this profile.
*/
public function user() {
return user_load($this->uid);
}
/**
* Sets a new user owning this profile.
*
* @param $account
* The user account object or the user account id (uid).
*/
public function setUser($account) {
$this->uid = is_object($account) ? $account->uid : $account;
}
/**
* Gets the associated profile type object.
*
* @return ProfileType
*/
public function type() {
return profile2_get_types($this->type);
}
/**
* Returns the full url() for the profile.
*/
public function url() {
$uri = $this->uri();
return url($uri['path'], $uri);
}
/**
* Returns the drupal path to this profile.
*/
public function path() {
$uri = $this->uri();
return $uri['path'];
}
public function defaultUri() {
return array(
'path' => 'user/' . $this->uid,
'options' => array('fragment' => 'profile-' . $this->type),
);
}
public function defaultLabel() {
if (module_exists('profile2_i18n')) {
// Run the label through i18n_string() using the profile2_type label
// context, so the default label (= the type's label) gets translated.
return entity_i18n_string('profile2:profile2_type:' . $this->type . ':label', $this->label);
}
return $this->label;
}
public function buildContent($view_mode = 'full', $langcode = NULL) {
$content = array();
// Assume newly create objects are still empty.
if (!empty($this->is_new)) {
$content['empty']['#markup'] = '' . t('There is no profile data yet.') . '';
}
return entity_get_controller($this->entityType)->buildContent($this, $view_mode, $langcode, $content);
}
public function save() {
// Care about setting created and changed values. But do not automatically
// set a created values for already existing profiles.
if (empty($this->created) && (!empty($this->is_new) || !$this->pid)) {
$this->created = REQUEST_TIME;
}
$this->changed = REQUEST_TIME;
parent::save();
// Update the static cache from profile2_load_by_user().
$cache = &drupal_static('profile2_load_by_user', array());
if (isset($cache[$this->uid])) {
$cache[$this->uid][$this->type] = $this->pid;
}
}
}
/**
* Use a separate class for profile types so we can specify some defaults
* modules may alter.
*/
class ProfileType extends Entity {
/**
* Whether the profile type appears in the user categories.
*/
public $userCategory = TRUE;
/**
* Whether the profile is displayed on the user account page.
*/
public $userView = TRUE;
public $type;
public $label;
public $weight = 0;
public function __construct($values = array()) {
parent::__construct($values, 'profile2_type');
}
/**
* Returns whether the profile type is locked, thus may not be deleted or renamed.
*
* Profile types provided in code are automatically treated as locked, as well
* as any fixed profile type.
*/
public function isLocked() {
return isset($this->status) && empty($this->is_new) && (($this->status & ENTITY_IN_CODE) || ($this->status & ENTITY_FIXED));
}
/**
* Overridden, to introduce the method for old entity API versions (BC).
*
* @todo Remove once we bump the required entity API version.
*/
public function getTranslation($property, $langcode = NULL) {
if (module_exists('profile2_i18n')) {
return parent::getTranslation($property, $langcode);
}
return $this->$property;
}
/**
* Overrides Entity::save().
*/
public function save() {
parent::save();
// Clear field info caches such that any changes to extra fields get
// reflected.
field_info_cache_clear();
}
}
/**
* View a profile.
*
* @see Profile::view()
*/
function profile2_view($profile, $view_mode = 'full', $langcode = NULL, $page = NULL) {
return $profile->view($view_mode, $langcode, $page);
}
/**
* Implements hook_form_FORMID_alter().
*
* Adds a checkbox for controlling field view access to fields added to
* profiles.
*/
function profile2_form_field_ui_field_edit_form_alter(&$form, &$form_state) {
if ($form['instance']['entity_type']['#value'] == 'profile2') {
$form['field']['settings']['profile2_private'] = array(
'#type' => 'checkbox',
'#title' => t('Make the content of this field private.'),
'#default_value' => !empty($form['#field']['settings']['profile2_private']),
'#description' => t('If checked, the content of this field is only shown to the profile owner and administrators.'),
);
}
else {
// Add the value to the form so it isn't lost.
$form['field']['settings']['profile2_private'] = array(
'#type' => 'value',
'#value' => !empty($form['#field']['settings']['profile2_private']),
);
}
}
/**
* Implements hook_field_access().
*/
function profile2_field_access($op, $field, $entity_type, $profile = NULL, $account = NULL) {
if ($entity_type == 'profile2' && $op == 'view' && !empty($field['settings']['profile2_private']) && !user_access('administer profiles', $account)) {
// For profiles, deny general view access for private fields.
if (!isset($profile)) {
return FALSE;
}
// Also deny view access, if someone else views a private field.
$account = isset($account) ? $account : $GLOBALS['user'];
if ($account->uid != $profile->uid) {
return FALSE;
}
}
}
/**
* Implements hook_field_extra_fields().
*
* We need to add pseudo fields for profile types to allow for weight settings
* when viewing a user or filling in the profile types while registrating.
*/
function profile2_field_extra_fields() {
$extra = array();
foreach (profile2_get_types() as $type_name => $type) {
// Appears on: admin/config/people/accounts/display
if (!empty($type->userView)) {
$extra['user']['user']['display']['profile_' . $type_name] = array(
'label' => t('Profile: @profile', array('@profile' => $type->label)),
'weight' => $type->weight,
);
}
// Appears on: admin/config/people/accounts/fields
if (!empty($type->data['registration'])) {
$extra['user']['user']['form']['profile_' . $type_name] = array(
'label' => t('Profile: @profile', array('@profile' => $type->label)),
'description' => t('Appears during registration only.'),
'weight' => $type->weight,
);
}
}
return $extra;
}
/**
* Entity metadata callback to load profiles for the given user account.
*/
function profile2_user_get_properties($account, array $options, $name) {
// Remove the leading 'profile_' from the property name to get the type name.
$profile = profile2_load_by_user($account, substr($name, 8));
return $profile ? $profile : NULL;
}