| 6 |
|
|
| 7 |
The bio module is a simple custom node-type module with a few "extras". |
The bio module is a simple custom node-type module with a few "extras". |
| 8 |
|
|
| 9 |
1) Unless a user has "administer nodes" permissions, they can only create *one* bio entry. |
1) Unless a user has "administer nodes" permissions, he or she can only create *one* bio entry. |
| 10 |
2) Any content that a user creates will receive a link to their bio entry. |
2) Any content that a user creates will receive a link to their bio entry. |
| 11 |
|
3) The bio entry for a user will be published whenever the user's account is active, and unpublished whenever the account is blocked. If you wish to use this feature on a site that requires administrator approval for new accounts, your bio content type should default to unpublished. |
| 12 |
|
|
| 13 |
The module does not use any custom fields and does not require installation of any database tables. |
The module does not use any custom fields. It installs one small database table for associating bio nodes with user ids. |
| 14 |
|
|
| 15 |
When configuring a site using this module, I recommend either: |
When configuring a site using this module, I recommend either: |
| 16 |
a) going to admin/themes/settings and disabling the "Display post information on" checkboxes |
a) going to admin/build/themes/settings and disabling the "Display post information on" checkboxes |
| 17 |
and/or |
and/or |
|
b) disabling "access user profiles" for non-admin site visitors on the admin/access page so that there is not both a link to the user's account profile page and their bio. |
|
| 18 |
|
b) disabling "access user profiles" for non-admin site visitors on the admin/user/access page so that there is not both a link to the user's account profile page and their bio. |
| 19 |
|
|
| 20 |
|
----------------------------------------------------------- |
| 21 |
|
Views Integration |
| 22 |
|
----------------------------------------------------------- |
| 23 |
|
|
| 24 |
|
The bio module now boasts integration with the views module. This integration takes two forms: |
| 25 |
|
|
| 26 |
|
1. Custom filters: Bio has two useful filters, Node: Type is bio and Bio: Author has bio node |
| 27 |
|
- Node: Type is bio node -- This is useful for shipping premade views that rely on bio, but are not tied to a particular type of node acting as the bio node (e.g. on one site it might be "Biography" on another "profile"). |
| 28 |
|
- Bio: Author has bio node -- This is useful for only returning results where the author has created a bio node. That way, if you are exposing bio fields (e.g. the "interests" taxonomy), you can be sure that a bio node exists for every other node returned in the query. |
| 29 |
|
|
| 30 |
|
2. Duplicating existing views tables, fields, filters, and sorts: Bio "steals" the views definitions of every other module and makes them its own. For example, the node module exposes the "Node: Title" field and filters. Bio steals these and creates the "Bio: Node: Title". Using these fields you can create a view that returns a list of blog nodes with the author's bio node title. Don't worry, it sounds complicated at first, but you'll get the hang of it in no time. |
| 31 |
|
|
| 32 |
|
Bio ships two default views that show the power of these two features: |
| 33 |
|
|
| 34 |
|
1. recent_biographies: This view uses the "Node: Type is bio" filter to give you a listing of recent bio nodes. But don't worry, if you have created a custom "Profile" or "My History" content type, it will still work. |
| 35 |
|
|
| 36 |
|
2. tracker_bio: Just like the usual tracker view, but with a twist! Instead of listing the node author's user name, this view uses the "Bio: Node: Title" field to list the author's bio node title. This works great for sites where users enter their names in their bio titles. |
| 37 |
|
|
| 38 |
|
If you find a problem with a particular view field, filter, or sort please post a bug in the bio module issue and also post a bug linking back to that issue in the original modules queue. Since bio doesn't create the tables, filters, fields, or sorts itself chances are the bug is elsewhere, but we'll work with other module creators to make their modules bio compliant. |