XMod Main Form Settings

With Business Directory, you may use several forms. A main data entry listing form, an Inquiry form, a sharing form, and an advanced search form.

Step 1. Configure Main Data Entry Form Settings

Select the form that you chose to use in Step 2 - Configure XMod.

Note: If you are using Xmod 5.5, the plain text editor is already selected. If your are using Xmod 5.1, make sure to select the plain text editor and not the form builder editor before clicking edit form.

Form settings allow you to select how many listings you will allow per user. For example, if you are selling business directory listing subscriptions you may want to set Maximum Records Per User to 1.

If you are logged into your portal as Administrator, this does not affect how many listings an Administrator may add and assign to other users.

Next you will be taken to the XMod edit form window. It is very important that we set the following parameters before we begin to add listings to Business Directory. The following form parameters will be saved with each listing. Any changes to these parameters, after you add listings, will require updating a listing for the changes to take effect.

Parameter changes to match your portal configuration:

1. DBobjectQualifier - This parameter is used for the SQL database calls in the form. It is a combination of the database user permission and the database qualifier. The parameter default is .dbo. In most cases you can leave this parameter set at its default value. If you have set a unique qualifier, during the DotNetNuke wizard installation, you will need to replace the default value with the user permission and qualifier. Note: This value is the prefix to all of your DotNetNuke database tables. Example: dbo.portal2_
    
2. cURL - The parameter default value is http://{XMOD_PortalAlias}/YOUR CONTACT PAGE. If you approve a listing as a Standard Listing, the listing will include a link, "Own this business? Enhance Your Listing". The cURL parameter is the Enhance Your Listing link. You can link this to your main contact us page or link to a subscription signup page that you have created on your site.
   
    
3. sEmail - The default value is {XMOD_PortalEmail} and returns the email associated with your portals's Administrator account for the Administrator that is set as the default Administrator on your DNN Admin >> Admin Settings page. This value is the From value used to send emails. You can change this to the email of your choice. This is the email address that will receive emails notices to approve listings.
    
4. smtpServ - The default value is mail.{XMOD_PortalAlias} and will return mail.YOURDOMAIN.com. You can change this default value to the SMTP server that matches your DotNetNuke portal settings.. Example: This setting may be different for your portal and hosting provider. If your email is working for other areas of your DNN portal, check the Host Tab >> Host Settings >> Advanced Settings >> SMTP Server Settings to discover what SMTP server setting is configured for your portal.
    
5. GoogleMapKey - The default is ENTER YOUR GOOGLE MAP KEY HERE. You must place this value with the Google Map Key that you obtained http://code.google.com/apis/maps/signup.html. This map key enables the Business Directory Google map.
    
6. InquiryFormTabID - The default value is 1. You will replace this value with the DNN page Tab Id that matches the Tab id of the page where your Inquiry form is located (Example: If your Inquiry form was installed at http://YOURDOMAIN.com/tabid/74/Default.aspx you would replace the InquiryFormTabID default value with 74). Note: This value is only used if your Inquiry form is set up on a unique DotNetNuke portal page. If you are using the DNNP-BD6.1 Inquiry Form 2 form, on the separate detail page, this value is not used.
    
7. ReferrerRole - This parameter creates a selection list of users from a specific DNN security role. The form default is Administrators. Its purpose is to allow you the option of assigning an affiliate referrer user to a specific listing. This can come in use if you pay commissions to affiliates who solicit listing clients on your behalf.
   
   A possible scenario would be to create a DNN security role named Affiliates and register users to this role that are your refferer agents. In this case, you would replace the ReferrerRole default, Administrators, with the Security role Affiliates (Example: parameter name="ReferrerRole" alias="ReferrerRole" default="Affiliates").
   
   
    
8. iDir - This parameter value should not be changed.
    
9. DiskQuota - The default value is 60  (60mb) and is used in the FatGeorge FileUpload control to set how much disk space each user is allowed.
    
10. LogothumbSize, LogoimageSize, LogoMaxFileSize, thumbSize, imageSize,ContactThumbSize, ContactImageSize, CouponThumbSize, CouponImageSize and maxFileSize are image sizing options. They can all be left at default values or can be changed to meet any special sizing needs for your portal page layout.
     
11. AudioMaxfileSize and VideoMaxfileSize - are audio and video sizing options if you are allowing these files to be uploaded to the local disk. If you are only using the Amazon S3 hosting and YouTube options they are not used and can remain at the default.
     
12. maxsDescriptSize, maxSpecialOfferSize, maxTestimonialSize, and maxBioSize  - are sizing parameters to the various text areas of the form. They can all be left at default values or can be changed to limit the length of user input.
     
13. gShowSocialBookmarks - The default value of this global option is yes. If value = yes, the social bookmarks appear on the listing detail view. Value options are yes or no.
     
14. gShowRatings - The default value of this global option is yes. If value = yes, the rating option will appear on the listing detail view. Value options are yes or no.
     
15. gRratingPermission - The default value of this global option is all.  Defines who can register a vote. Valid values are registered and all.
     
16. gShowUserReviews - The default value of this global option is yes. If value = yes, the user review option will appear on the listing detail view. Value options are yes or no.
     
17. gUserReviewApproval - The default value of this global option is true.  Determines whether all comments must be approved by an administrator (true) or whether they are auto-approved (false). Value options are true or false.
     
18. gAllowRatingReviewOverride - The accepted values are 'yes' or 'no'. If you choose yes, the listing moderator, on a per listing basis, on the Admin panel of the form, will have the option to show or not show ratings and visitor review sections on the detail page.
     
19. gAllowAudio, gAllowLocalDiskAudio, gAllowVideo, and gAllowLocalDiskVideo are global options that determine if the lister can add audio and video to their listing. gAllowLocalDiskAudio and gAllowLocalDiskVideo are specific global parameters that determine if the lister is allowed to upload local audio and video to your portals file system. The default values for gAllowLocalDiskAudio and gAllowLocalDiskVideo are 'no'. Value options are yes or no.

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.

Note: If you are using the categories and sub-categories form (DNNP-BD6.1 Sub Categories Form) special instructions are included in the documentation folder of the BD6.1.1-UnZipMe.zip (purchased Business Directory zip file) that you extracted to your local computer.

Next >> Configure Inquiry Form