XMod Form Settings

With Move My Inventory!, you will use two forms. A main data entry listing form and an optional Inquiry form.

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

The additional form is named MMI6 Inquiry Form and can optionally be used to create an email product or service inquiry form.

The installation package has already installed these forms for you and have configured these forms to match the Move My Inventory directory location on your portal installation.

Note: It is best practice to edit these forms in the plain text edit mode, copy them, and save them in Notepad. In the event of any unwanted modification, you can revert back to the originals.

Step 1. Configure Main Data Entry Form Settings

 

Note: It is very important to always choose the Plain Text editor when working with XMod forms and templates. If you have chosen another HTML editor such as Dreamweaver, FrontPage, or Expression Web always edit templates in code or source view and not in design view as they will become corrupted.

 

You will be redirected to the code view of the form.

 

Parameter settings give you the flexibility to modify many of the applications global settings. The majority of the parameter settings can remain with the default values.

 

Parameter changes to match your portal configuration:

Note: It is important to make any parameter changes before beginning to add inventory listings as these changes will be saved with the listing.

1. iDir - The image directory location. Do not modify.
2. bookmarkPathPage - Not required at this time
3. 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.
4. smtpMailServer - The default value is mail.{XMOD_PortalAlias} and will return mail.YOURDOMAIN.com.
    
5. DiskQuota, LogothumbSize, LogoImageSize, LogoMaxFileSize, thumbsize, imageSize, maxFileSize, AdusioMaxFilesize, and VideoMaxFileSize - Can be left at their default values or adjusted to meet your business needs.
    
6. maxDescriptionSize, maxCprofileSize, maxSpecsSize, maxNotesSize, maxTestimonialSize, maxSpecialOfferSize - Are the character length values of the Product/Service Listing Summary, Company Profile, The Specs, The Additional Information, The Testimonials, and the Special Offer text areas. These values can be left at their default values or adjusted to meet your business needs.
7. gShowSocialBookmarks - Show or not show social bookmark icons and links on a listing detail page. The accepted values are "yes" or "no"
    
8. 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.
    
9. 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.
    
10. redir - This is currently not in use but would allow you to modify the form to redirect to a page of your choice.

Note: After performing any moderation to the form parameters, it is best practice to save the entire parameters section to Notepad for safekeeping. When a new version of Move My Inventory is available you will want to replace the default parameters of the new version with your modified parameters.

Adding and Changing Category Names:

Below is an example of the category section of the MMI6 Single Category Form.

To change the default category names go to cboCategory section of the form and rename the categories to meet your needs (Example: Change Category 1 label and value to DNN Modules, etc.).

To add additional categories simple add another item line.

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

Note: For modifying categories for the MMI6 Multiple Category Form and the MMI6 Sub Categories Form refer to the documentation included in your download zip file that you had extracted to your local computer (See Installation instructions).

Note: After performing any moderation to the form categories, it is best practice to save the entire category section to Notepad for safekeeping. When a new version of Move My Inventory is available you will want to replace the default categories of the new version with your modified categories.

Step 2. Inquiry Form Settings

The MMI6 Inquiry Form will be used with the MMI6 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 module (separate detail page)

This form will receive its information from passed querysting parameters from the detail page links on the MMI6 List View 2 template.

 

Inquiry Form Configuration

 

 

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 MMI6 Inquiry Form to a FormView Module on a Page Where Your Separate Detail Page Resides

Note: The setup of a separate detail page using the XMod Detail View for XMod 5.0 - PA module is explained in the documentation Configuring Templates section.

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

2. Add a XMod FormView module to the page.

 

You will see this message:

This module needs to be configured.

From the module action menu select Configure XMod Module.

 

Next >> Configuring Templates