New Members functionality in Pegboard V6.0.11.1

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: