XMod Form Settings

With Business Directory, you will use two forms. A main data entry listing form and an Inquiry form.

Step 1. Configure Main Data Entry Form Settings

 

Parameter changes to match your portal configuration:

1. DBobjectQualifier - The form default is .dbo. If you have set a unique qualifyer when you set up your DNN database replace the default .dbo with your unique database qualifyer.
2. 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 commisions to affilates who solicit listing clients on your behalf.
   
   A possible scenario would be to create a DNN security role named Affilates and register users to this role that are your refferer agents. In this case, you would replace the RefferrerRole default, Administrators, with the Security role Affilates (Example: parameter name="ReferrerRole" alias="ReferrerRole" default="Affilates").
   
   
3. ContactURL - The form default is ENTER THE FULL URL OF YOUR CONTACT US PAGE HERE. Replace the default value with your page that the lister should be directed to if they want to enhance a standard listing. (Example: parameter name="cURL" alias="contactURL" default="http://YOURDOMAIN.COM/subscribe.aspx")
   
   
4. 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.
5. smtpMailServer - The default value is mail.{XMOD_PortalAlias} and will return mail.YOURDOMAIN.com.
6. 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.
7. 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).
8. 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.

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. Configure Inquiry Form Settings

The inquiry form will be added to a hidden page on your site and be called when a visitor clicks the 'Make Inquiry' button.

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 Inquiry Form to a FormView Module and a Page on Your Site

1. Create a page on your site and name it, for example, Business Directory Inquiry Form.

2. Add a XMod FormView module to the page.

You will see this message:

This module needs to be configured.

When you are configure mode note the tabid in the URL of the page.

Example: BusinessDirectoryInquiryForm/tabid/59/ctl/Configure/mid/392/Default.aspx

This will be used on the main form for the value of the parameter named InquiryFormTabID which is explained in Parameters step 7 above.

Next >> Configuring Templates