profile.rst 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. Profile
  2. =======
  3. .. figure:: images/profile.jpg
  4. :width: 180
  5. :align: right
  6. :alt: An Elgg profile
  7. An Elgg profile
  8. The profile plugin is bundled with both the full and core-only Elgg packages. The intention is that it can be disabled and replaced with another profile plugin if you wish.
  9. It provides a number of pieces of functionality which many consider fundamental to the concept of a social networking site, and is unique within the plugins because the profile icon it defines is referenced as standard from all over the system.
  10. User details
  11. ------------
  12. This provides information about a user, which is configurable from within the plugin's start.php file. You can change the available profile fields form the admin panel.
  13. Each profile field has its own access restriction, so users can choose exactly who can see each individual element. Some of the fields contain tags (for example *skills*) limiting access to a field will also limit who can find you by that tag.
  14. User avatar
  15. -----------
  16. .. figure:: images/user_hover_menu.jpg
  17. :width: 180
  18. :align: right
  19. :alt: The Elgg context menu
  20. The Elgg context menu
  21. The user avatar represents a user (or a group) throughout the site. By default, this includes a context-sensitive menu that allows you to perform actions on the user it belongs to wherever you see their avatar. For example, you can add them as a friend, send an internal message, and more. Each plugin can add to this context menu, so its full contents will vary depending on the functionality active in the current Elgg site.
  22. Notes for developers
  23. --------------------
  24. Using a different profile icon
  25. To replace the profile icon, or provide more content, extend the ``icon/user/default`` view.
  26. Adding to the context menu
  27. The context menu can be expanded by registering a :ref:`plugin hook <design/events#plugin-hooks>` for 'register' 'menu:user_hover', the following sections have special meaning:
  28. - **default** for non-active links (eg to read a blog)
  29. - **admin** for links accessible by administrators only
  30. In each case, the user in question will be passed as ``$params['entity']``.