Introduction
This documentation covers the recent changes to the Members module:
- Members role update via members content form
- View other members bookmarked items
- Allow members to select a role via a form
- Allow the pbMemberActivitySummary skintag to display ratings
- Allow the pbMemberBlogCommentForm to support ratings
Minimum Requirements
Pegboard V6.0.11.1
Updating the role of a member via the pbMemberContentFormSubmit
The pbMemberContentFormSubmit skintag has been updated to have the following new properties:
- "IsUpgrade" – False
- "RemoveExistingRoles" – False
- "PendingMembersContentActive" – False
- "PendingMembersContentVisible" – False
The “IsUpgrade” property is
to be used in conjunction with the property “isPaymentRequired” to
trigger the code to create a pending upgraded members content item. This
pending item is a copy of the live members content item with the
updated details that were on the upgrade form.
The “RemoveExistingRoles”
property is used in conjunction with the properties “IsUpgrade” and
“isPaymentRequired” to create a pending member, which is a copy of the
currently logged in member with updated role/s based on the role set on
the billing product.
The pending members content
and pending member are made live when a successful credit card payment
is completed, or when an order is marked as approved.
In the console there is now a search criteria option to view the pending items in that collection.

The
“PendingMembersContentActive” and “PendingMembersContentVisible”
properties override the active and visible attributes on the pending
members content collection item. You would set these properties to true
if you needed to display the pending items on the front-end of the site.
Example of a pbMemberContentFormSubmit skintag:
[pbMemberContentFormSubmit
ContentParent="Restaurants" NewMemberContentActive="False"
ObjectType="Datalist" RemoveExistingRoles="True" IsUpgrade="True"
BillingProduct="Paid Restaurant Listing"]
View other members bookmarked items
All of the collection list
skintags (such as pbAdvCollection, pbCollection, pbCollectionList) have
been updated to display bookmarked items from another member.
When a collection listing is setup to display bookmarks (showBookmarksOnly =”true”)
it will display the bookmarks for the currently logged in member. To
display bookmarks for another member, pass in the parameter “mref” into
the URL with the value of another member id. For example:
http://yourstie.com.au/bookmarks.aspx?mref=ACF53361-C4DC-436C-AFF3-676C94A13008
Allow members to select a role via a form
The
pbMemberSignupFormSubmit has been updated to include a new property
“RoleFieldNames” which takes a comma separated listing of form field
names. The fields specified can be a dropdown, checkbox, checkbox list,
or radio button list.
When setting up these
fields, the “items” attributes needs to contain a listing of the role
names. In the example below I have setup the items attribute for the
radio button list with the following:
business_shopping_paid;business_shopping_premium

An example of the pbFormFields and pbMemberSignupFormSubmit used to setup the form is:
[pbFormField Field="RolesField" FormName="SignupForm" FormGroup="SignupForm"]
[pbFormField Field="RolesField2" FormName="SignupForm" FormGroup="SignupForm"]
[pbFormField Field="RolesField3" FormName="SignupForm" FormGroup="SignupForm"]
[pbMemberSignupFormSubmit FormName="SignupForm" RoleFieldNames="RolesField,RolesField2,RolesField3" FormGroup="SignupForm"]
Allow the pbMemberActivitySummary skintag to display ratings
Ratings can be displayed
on the pbMemberActivitySummary skintag by setting the new property
“ShowRatings” to true. When ratings are enabled, you can customise the
appearance via the following properties.
RatingImageHeight - 0
RatingImageWidth - 0
RatingImageYesNoHeight - 0
RatingImageYesNoWidth - 0
RatingImage – “”
RatingImageHighlighted – “”
RatingImageYes - "/system/images/ratings/up.png"
RatingImageYesHighlighted - "/system/images/ratings/uph.png"
RatingImageNo - "/system/images/ratings/down.png"
RatingImageNoHighlighted - "/system/images/ratings/downh.png"
FilterByRatingGroup - "all"
HideRatingLabelDiv – False
An example:

Allow the pbMemberBlogCommentForm to support ratings
The pbMemberBlogCommentForm has been extended to allow a rating to be submitted with the comment.
The full list of new properties available on this skintag are:
RatingImage - ""
RatingImageHover - ""
RatingImageHoverSelected - ""
RatingImageHeight - 0
RatingImageWidth - 0
RatingImageYesNoHeight - 0
RatingImageYesNoWidth - 0
RatingImageHighlighted - ""
RatingImageYes - "/system/images/ratings/up.png"
RatingImageYesHighlighted - "/system/images/ratings/uph.png"
RatingImageNo - "/system/images/ratings/down.png"
RatingImageNoHighlighted - "/system/images/ratings/downh.png"
AllowMultipleVotes - True
An example:
