XMod Form Settings

With Review IT!, you will use two forms. A main data entry listing form and an optional Sharing form.

Included in the application package is a selection of three main data entry forms. They are named RI6 Single Category Form (add your review listing to a single category), RI6 Multiple Category Form (add your review listing to multiple categories), and RI6 Sub Categories Form (add your review listing to a single category and a single or multiple sub categories).

Step 1. Configure Main Data Entry Form Settings

 

It is very important to always choose the Plain Text editor when working with XMod forms and templates.

If you intend to modify the code in HTML editors such as FrontPage or Dream Weaver, always work on the forms and templates in code view.

Parameter changes to match your portal configuration:

Note: It is important to make any parameter changes before beginning to add listings.

1. iDir - The image directory location. Do not modify.
2. sEmail - The default value is {XMOD_PortalEmail} and returns the email associated with your portals's Administrator account. This value is the From value used to send emails.
3. smtpMailServer - The default value is mail.{XMOD_PortalAlias} and will return mail.YOURDOMAIN.com.
    
4. DiskQuota, LogothumbSize, LogoImageSize, LogoMaxFileSize, thumbsize, imageSize, maxFileSize, AdusioMaxFilesize, and VideoMaxFileSize - Can be left at their default values or adjusted to meet your business needs.
    
5. maxDescriptionSize, maxCprofileSize, maxSpecsSize, maxProsSize, maxConsSize, maxBLineSize, maxSpecialOfferSize - Are the character length values of the Product Summary, Company Profile, The Specs, The Pros, The Cons, The Bottom Line and the Special Offer text areas. These values can be left at their default values or adjusted to meet your business needs.
    
6. gShowRatings, gRatingPermission, gShowuserReviews, gUserReviewApproval - With these values you can decide to allow visitor ratings and reviews.
   
   gRatingPermission - valid values are 'all' or 'registered'. If choose registered, only registered site users can add ratings.
   
   gUserReviewApproval - valid values are 'true' or 'false'. If choose true, the site Administrator will need to approve all visitor added reviews.
    
7. gAllowRatingReviewOverride, gAllowAudio, gAllowLocaldiskAudio, gAllowVideo, gAllowLocaldiskVideo
   
   gAllowRatingReviewOverride - The accepted values are 'yes' or 'no'. If you choose yes, the review editor, on a per listing basis, will have the option to show or not show ratings and visitor review sections on the detail page.
   
   gAllowAudio - The accepted values are 'yes' or 'no'. If you choose yes, the review editor has the option to add audio to the review listing.
   
   gAllowLocaldiskAudio - The accepted values are 'yes' or 'no'. If you choose yes, the review editor has the option to upload audio to your hosting server.
   
   gAllowVideo - The accepted values are 'yes' or 'no'. If you choose yes, the review editor has the option to add video to the review listing.
   
   gAllowLocaldiskVideo - The accepted values are 'yes' or 'no'. If you choose yes, the review editor has the option to upload video to your hosting server. If you select no, the review editor can add video from Amazon S3 hosting service or YourTube.
    
8. redir - This is currently not in use but would allow you to modify the form to redirect to a page of your choice.

 

Adding and Changing Category Names:

To change the default category names go to cboCategory section of the form and rename the categories to meet your needs (Example: Change Category 2 to General Business).

To add additional categories simple add another item line.

Finally Save Form and then click Done to return to your Listing page.

Step 2. Share Form Settings

The share, or Tell-a-Friend form will be used with the RI6 Detail View 2 template that will be described in the template section.

This form is optional and is designed to reside on the detail page when using the XMod Detail View for XMod 5.0 - PA (separate detail page)

Save Settings

In the parameters, above, there are two parameters that allow the form to send mail:

parameter name="sEmail"

parameter name="smtpServ"

sEmail defaults to the value {XMOD_PortalEmail}. This equates to Your DotNetNuke Administrator account email address. When a form is submitted the Company email on the main data entry form will be sent an inquiry email. Also the email account associated with the parameter sEmail will receive an email.

smtpServ is the value for your SMTP server and defaults the SMTP mail server setting to the value mail.{XMOD_PortalAlias}. This equates to mail.Your Domain Name.com

Change these values if they do not meet your site's email requirements.

Save Form

Click Done

Add Sharing Form to a FormView Module and a Page Where Your Separate Detail Page Resides

1. Create a page on your site and name it, for example, Review Detail.

2. Add a XMod FormView module to the page.

You will see this message:

This module needs to be configured.

Next >> Configuring Templates