Difference between revisions of "Signup Page"

From SmartWiki
Jump to: navigation, search
(Signup Page Content)
(Client Categories)
 
(120 intermediate revisions by 3 users not shown)
Line 3: Line 3:
  
 
=Configuration - Essentials=
 
=Configuration - Essentials=
==Creating a signup page==
+
==Creating a Signup Page==
 
===The Associated Organization===
 
===The Associated Organization===
Before you create a signup page, you will need to decide where the users and organizations you are creating will reside in your organization hierarchy. In other words, when you create a new user or organization via a signup page, where will they be created in your system? Typically, you would create an organization in the external organization hierarchy and call it something like Web Registrants. Later you would associate that organization with your signup page. Then all new users and organizations created by this specific signup page will be created under that organization.
+
Before you create a signup page, you will need to decide where the users and organizations you are creating will reside in your organization hierarchy. In other words, when you create a new user or organization via a signup page, where will they be created in your system? Typically, you would create an organization in the external organization hierarchy and call it something like "Web Registrants". Later you would associate that organization with your signup page. Then all new users and organizations created by this specific signup page will be created under that organization.
  
You can set up an organization by going to '''Menu''' icon > '''Organization Hierarchy''' > click on the second tab which is the external hierarchy, and click the '''New''' button to create a new organization in the external organization hierarchy.
+
If you are creating an organization to act structurally like a holding folder rather than a true organization, then you need to flag the organization as such. If you flag an organization as a container, any hierarchy access granted in the security matrix to organizations will not be applied for the container organization.
 +
 
 +
To flag an organization as a container go to '''Menu Icon''' > '''Organizations''' > Edit an Organization > '''Actions''' > '''Edit Categories and Access''' > Toggle on '''Container'''.
 +
 
 +
To set up an organization go to '''Menu Icon''' > '''Organization Hierarchy''' > Click on the second tab which is the external hierarchy, and click the '''New''' button to create a new organization in the external organization hierarchy.
  
 
===Roles and Categories===
 
===Roles and Categories===
 
: ''Main Articles: [[User Role]] & [[Client Categories]]''
 
: ''Main Articles: [[User Role]] & [[Client Categories]]''
Once you have an organization set up that you will associate with a signup page, next you will need to set up '''Roles''' (for users) and '''Categories''' (for organizations).
+
Once you have set up an organization to associate with a signup page, you will need to set up '''Roles''' (for users) and '''Categories''' (for organizations).
'''[[User Role|Roles]]''' are a way of grouping like users together. We use roles to control what the user can see and do in the system. When you create a user via a signup page, you need to give them one or more roles. Typically, you would give a user a role like "Applicant" or "Reviewer".
+
 
Before you create your signup page, make sure you have created the roles you intend to give to the new users.
+
====User Roles====
You can setup user roles by going to '''Menu''' icon > '''Global Settings''' > '''Users''' tab > '''Roles''' and click the '''New''' button.
+
'''[[User Role|Roles]]''' are a way of grouping like users together. We use roles to control what the user can see and do in the system. When you create roles, you can indicate if a role is only for internal or external users. For example, typically the "Applicant" role should only be given to external users.
'''[[Client Categories|Categories]]''' are a way of grouping like organizations together and are also used to control what can be seen and done. When you create an organization via a signup page, you need to give them one or more categories. Typically, you would give an organization the category of "Grant Seeking Organization" or "External Reviewers".
+
 
Before you create your signup page, make sure you have created the desired categories for your organization.
+
When you create a user via a signup page, you need to give the user one or more roles. Typically, you would give a user a role like "Applicant" or "Reviewer". Before creating your signup page, ensure that you have created the roles you will assign to newly created users. You can setup user roles by going to '''Menu Icon''' > '''Global Settings''' > '''Users''' tab > '''Roles''' and click the '''New Role''' button.
 +
 
 +
====Organization Categories====
 +
'''[[Client Categories|Categories]]''' are a way of grouping like organizations together and are also used to control what can be seen and done. When you create an organization via a signup page, you need to give the organization one or more categories. Typically, you would give an organization the category of "Grant Seeking Organization" or "External Reviewers".
  
You can setup organization categories by going to '''Menu''' icon > '''Global Settings''' > '''Organization''' tab > '''Categories''' and click the '''New''' button.
+
Before creating your signup page, ensure that you have already created the categories you will assign to newly created organizations. You can set up organization categories by going to '''Menu''' Icon > '''Global Settings''' > '''Organization''' tab > '''Categories''' and click the '''New''' button.
  
 
===Statuses===
 
===Statuses===
 
: ''Main Article: [[Status]]''
 
: ''Main Article: [[Status]]''
Lastly, you may want to set up a [[Status|status]] for users and organizations. Statuses are like a place in time. For example, you might use a “Newly Registered” status for new registrants, and later once they have been vetted, you might switch them to an “Active” Status and later when you no longer engage with the user you might move them to an “Inactive” status.
+
Lastly, set up a [[Status|status]] for users and organizations. Statuses are like a place in time. For example, you might use a "Newly Registered" status for new registrants, and later once these users are vetted, you might switch them to an “Active” Status and later when you no longer engage with the user you might move them to an “Inactive” status.
Before you create your signup, pages create desired statuses.
+
Before creating your signup page, ensure that you have created the statuses you will assign to newly created users and organizations.
You can set up a user status by going to '''Menu''' icon > '''Global Settings''' > '''User''' tab > '''Statuses''', and click the '''New''' button to create a user status.
+
You can set up a user status by going to '''Menu Icon''' > '''Global Settings''' > '''User''' or '''Organization''' tab > '''Statuses''', and click the '''New''' button to create a user or organization status.
==Creating a user signup page==
+
 
The user signup page creates people in your system. Users created via a signup page typically login and do something in your system, such as applying for a grant or reviewing a grant application.
+
==Creating a User Signup Page==
 +
The user signup page adds or updates individuals within your system. Users created in the system via a signup page typically login and do something in your system, such as applying for or reviewing a grant application.
  
 
[[File:Signup-user.png|thumb|none|800px|Sample user signup page]]
 
[[File:Signup-user.png|thumb|none|800px|Sample user signup page]]
  
===How to setup a user signup page===
+
===How to Set up a User Signup Page===
 
# Go to the '''Menu''' Icon > '''Global Settings''' > '''Users''' Tab > '''Signup Pages''' Link.
 
# Go to the '''Menu''' Icon > '''Global Settings''' > '''Users''' Tab > '''Signup Pages''' Link.
 
# Click the '''New Signup Page''' button in the action bar. It looks like a plus sign.
 
# Click the '''New Signup Page''' button in the action bar. It looks like a plus sign.
 +
# Enter a name for the signup page that will be used to distinguish it from other pages, but will not be visible to the end user.
 
# Choose an '''Associated Organization''' via the lookup. New users will be created under the associated organization. Generally, you want to select an external organization.
 
# Choose an '''Associated Organization''' via the lookup. New users will be created under the associated organization. Generally, you want to select an external organization.
# Enter a '''Description'''. This is not seen by your applicants but it is important as it is the only way you can tell user signup pages apart when you are picking a user signup page from the organization signup configuration page.
+
# Enter a '''Description'''. This is not seen by your applicants but it is important as it helps differentiate user signup pages when you are picking a user signup page from the organization signup configuration page.
# Enable '''CAPTCHA Validation''', as well as '''Duplicate Check''' Conditions based on the security needs of your organization.
+
# Change the '''Access Type''' to '''User Access''' if you want the user to be able to login.
# If you want the user to be able to login, change the '''Access Type''' to '''User Access'''.
+
# For '''Roles to Add''' select the desired roles to be assigned to the user.
# Add desired roles to be assigned in '''Roles to Add'''.
 
 
# Modify the '''Signup Page Content''' and '''Confirmation Page Content''' as desired. Typically in the instructions you might want to add a phone number or email of who to contact if the user is having trouble registering. On the confirmation page content you might want to add something like "''check your email and spam folder in your email for instructions on how to gain access to the system''."
 
# Modify the '''Signup Page Content''' and '''Confirmation Page Content''' as desired. Typically in the instructions you might want to add a phone number or email of who to contact if the user is having trouble registering. On the confirmation page content you might want to add something like "''check your email and spam folder in your email for instructions on how to gain access to the system''."
# Drag and drop the fields from the '''Available Fields''' list into the '''Selected Fields''' list. These are the fields that will appear on the signup page. Once fields are in the '''Selected Fields''' list you drag and drop fields to reorder them or hover over a field and click the grey '''x''' button to remove the field from the list.
+
# Drag and drop the fields from the '''Available Fields''' list into the '''Selected Fields''' list. These are the fields that will appear on the signup page. Once fields are in the '''Selected Fields''' list you may drag and drop fields to reorder them or hover over a field and click the grey '''x''' button to remove the field from the list. If you are adding the address fields, typically the country input should appear above the state/province drop down so that the list of states or provinces can be filtered based on the country. 
 
# Click '''Save'''.
 
# Click '''Save'''.
  
==Creating an organization signup page==
+
==Creating an Organization Signup Page==
 
The organization or company signup page creates organizations within your system.
 
The organization or company signup page creates organizations within your system.
  
===How to setup an organization signup page===
+
===How to Set up an Organization Signup Page===
 
# Go to the '''Menu''' Icon > '''Global Settings''' > '''Organizations''' tab and click on the '''Signup Pages''' Link.
 
# Go to the '''Menu''' Icon > '''Global Settings''' > '''Organizations''' tab and click on the '''Signup Pages''' Link.
 
# Click the '''New Signup Page''' button in the action bar. It is signified by a plus sign.
 
# Click the '''New Signup Page''' button in the action bar. It is signified by a plus sign.
# Choose an '''Associated Organization''' via the lookup. New users will be created under this organization. Generally, you want to select an external organization.
+
# Give the signup page a name.
# Enable '''CAPTCHA Validation''' and '''Duplication Check''' Restrictions based off of your security needs.
+
# Choose an '''Associated Organization''' via the lookup. New organizations will be created under this organization. Generally, you want to select an external organization.
# Choose the organization '''Categories''' you want to assign to new organizations from the signup page.
+
# Optionally, enter a description. This will not be visible to applicants but is important for differentiating organization signup pages. You can include the purpose and usage of the page to make it easier to find and provide context.
# Change the content on the signup page and confirmation page with a custom message. Typically, you will want to add something like who the user should contact if they need assistance.
+
# For '''Categories''' select the categories you want to assign to new organizations created.
# Drag and drop the fields from the '''Available Fields''' list into the '''Selected Fields''' list. These fields will appear on the organization signup page. Fields in the Selected Fields List can be reordered using drag and drop. 
+
# Change the signup page and confirmation page content if desired. For example you may want to add something like who the user should contact if they need assistance. If a user signup page is attached to an organization signup page, the confirmation page content of the user signup page will be used and the organization confirmation page content will be ignored.
 +
# Drag and drop the fields from the '''Available Fields''' list into the '''Selected Fields''' list. These fields will appear on the organization signup page. Fields in the Selected Fields List may be reordered using drag and drop. If you are adding the address fields, typically the country input should appear above the state/province drop down so that the list of states or provinces can be filtered based on the country.
 
# Click '''Save'''.
 
# Click '''Save'''.
  
==Creating a combined User and Organization signup page==
+
==Creating a Combined User and Organization Signup Page==
 
Typically, you will want to create an organization and one or more users at the same time.
 
Typically, you will want to create an organization and one or more users at the same time.
  
 
[[File:Signup-org-single-user.png|thumb|none|800px|A signup page that creates a single organization and single user at the same time.]]
 
[[File:Signup-org-single-user.png|thumb|none|800px|A signup page that creates a single organization and single user at the same time.]]
  
You can create a user and organization at the same time by:
+
You can create signup page that will create one or more users and organization at the same time by:
  
# Create a user signup page.
+
# Create a user signup page as above.
# Create an organization signup page.
+
# Create an organization signup page as above.
# Edit the organization signup page, and for the setting called '''User Signup''' pick either '''Single User''' or '''Multiple Users'''.
+
# Edit the organization signup page, and for the setting called '''User Signup''' select either '''Single User''' or '''Multiple Users'''.
# If you picked '''Single User''' you will see a '''User Signup Page''' setting. Click the drop down and select the desired user signup page.
+
# If you picked '''Single User''' you will see a '''User Signup Page''' setting. Click the drop down and select the desired user signup page. Having a unique description on the user signup page will help make selection easy.
# ''(Optional)'' Toggle on '''Enable Same Address Button''' if you want the user’s address to be pre-populated with the address of the company.
+
# ''(Optional)'' Toggle on '''Enable Same Address Button''' if you want the user’s address to be pre-populated with the address of the organization so the user does not need to enter the same address twice.
 
# Click '''Save'''.
 
# Click '''Save'''.
  
Note: when you choose a user signup page, it will show up inside the organization signup page in its own section under the organization details. Also note that when a user signup page is attached, the ''user'' signup confirmation page is used. Therefore, if you want to make changes to the confirmation page that appears to the user upon submission, you will need to navigate the user signup page instead.
+
<u>'''Note''':</u> When you choose a user signup page, it will show up inside the organization signup page in its own section under the organization details. Also note that when a user signup page is attached, the ''user'' signup confirmation page is used. Therefore, if you want to make changes to the confirmation page that appears to the user upon submission, you will need to navigate the user signup page instead.
  
 
[[File:Signup-org-multi-user.png|thumb|none|800px|A signup page that creates a single organization and multiple users at the same time. In this example the Lead Applicant is set to a minimum of 1 so they are required. The co-applicant is set to a minimum of 0 and maximum of 3 so none or up to 3 co-applicants can register at the same time.]]
 
[[File:Signup-org-multi-user.png|thumb|none|800px|A signup page that creates a single organization and multiple users at the same time. In this example the Lead Applicant is set to a minimum of 1 so they are required. The co-applicant is set to a minimum of 0 and maximum of 3 so none or up to 3 co-applicants can register at the same time.]]
Line 80: Line 89:
 
You can specify a minimum and maximum number of users you want to create per attached signup page as well as specify section and user titles.
 
You can specify a minimum and maximum number of users you want to create per attached signup page as well as specify section and user titles.
  
Note: depending on your jurisdiction, be mindful that if you enable multiple users, you are asking someone to enter personally identifying information, into your system on someone else’s behalf.
+
<u>'''Note:'''</u> Depending on your jurisdiction, be aware that enabling multiple users means you are asking someone to enter personally identifiable information on behalf of another person, which may not comply with certain regulations.
  
==Making changes to fields on your signup page==
+
==Making Changes to Fields on Your Signup Page==
Let’s say you want to make the '''Email''' field on your user signup page mandatory. Navigate to the '''User''' standard field for email: '''Menu''' Icon > '''Global Settings''' > '''Users''' Tab > '''Standard Fields''' link and edit the '''Email''' standard field by toggling on the '''Mandatory''' setting. Now when you go back to the signup page and preview it, you will see the email field is now set to mandatory and the relevant validation was automatically added.
+
Let’s say you want to make the '''Email''' field on your user signup page mandatory. Navigate to the '''User''' standard field for email: '''Menu Icon''' > '''Global Settings''' > '''Users''' Tab > '''Standard Fields''' link and edit the '''Email''' standard field by toggling on the '''Mandatory''' setting. Now when you go back to the signup page and preview it, you will see the email field is now set to mandatory and the relevant validation was automatically added.
  
 
Any changes you make to any fields that are included on a signup page will be updated instantaneously on your signup pages. You can also go back to the signup page at any time to change the order of fields and add or remove fields by modifying the selected fields. To remove a field, hover over the desired field and click the button marked with an '''x'''. Drag and drop '''Selected Fields''' to modify the order in which the fields will appear on the signup page.
 
Any changes you make to any fields that are included on a signup page will be updated instantaneously on your signup pages. You can also go back to the signup page at any time to change the order of fields and add or remove fields by modifying the selected fields. To remove a field, hover over the desired field and click the button marked with an '''x'''. Drag and drop '''Selected Fields''' to modify the order in which the fields will appear on the signup page.
  
 
==Modifying the New User Email Template==
 
==Modifying the New User Email Template==
If you are giving new users the ability to login in via the '''Access Type''' setting, which gets set to '''User Access''', then the user will receive an email based off a '''New User Email Template,''' either the one on the signup page or the global template.
+
New users who can log in will receive an email containing an activation link. To enable this, the signup page must have the '''Access Type''' set to '''User Access'''.
 +
 
 +
The email the user receives by default is configured globally and is located at '''Menu''' Icon > '''Global Settings''' > '''Security''' Tab > '''Password and Activation Policies''' > '''Activation Emails''' in the left navigation. Once you add the sample template you can modify it as needed. The sample template will send the new registrant a link where they can enter their desired password to complete user activation. The variable for this is:
  
By default, all new users will receive the email template found in '''Menu''' Icon > '''Global Settings''' > '''Security''' Tab > '''Password and Activation Policies''' > '''Activation Emails''' in the left navigation. Once you add the sample template you can modify it as needed. The sample template will send the new registrant a link where they can enter their desired password to complete user activation. The variable for this is '''https://@url@@activationlink@'''. It is also possible to email users their username and password by using the variables '''@email@''' and '''@password@''' and using the other basic syntax references of the [[Variable Processor|variable processor]].
+
<pre>https://@url@@activationlink@</pre>
  
If you want a custom new user email sent to all users who register through this specific signup page instead of using the global one, then, on that particular signup page, go to the '''Templates''' tab and add the sample template and fill in the other fields. The '''New User Email Template''' on the signup page takes precedence over the '''New User''' general template found under '''Global Settings'''. Typically, we recommend that you leave the '''Template''' tab '''New User Email Template''' empty so the global template will be used.
+
If you want a custom new user email sent to users who register through this specific signup page only, instead of using the global template, then, on that particular signup page, go to the '''Templates''' tab and add the sample template and fill in the other fields. The '''New User Email Template''' on the signup page takes precedence over the '''New User''' general template found under '''Global Settings'''. Typically, we recommend that you leave the '''Template''' tab '''New User Email Template''' empty and use the global template instead.
  
 
==Setting Up Privacy Policies==
 
==Setting Up Privacy Policies==
 +
: ''Main Article: [[Privacy_and_Security_Policies|Privacy and Security Policies]]''
 
A privacy policy details your company’s views and procedures related to the collection of information on people who use your system. It's important to let your users know how you are going to use the information you are requesting, and to tell users who to contact should they have questions. In some jurisdictions, such as California, you are required to post your privacy policy by law. In the EU, the [[General Data Protection Regulation (GDPR)]] and the e-privacy directive oblige you to display a privacy notice containing specific elements on your system. Failure to do so can result in fines.
 
A privacy policy details your company’s views and procedures related to the collection of information on people who use your system. It's important to let your users know how you are going to use the information you are requesting, and to tell users who to contact should they have questions. In some jurisdictions, such as California, you are required to post your privacy policy by law. In the EU, the [[General Data Protection Regulation (GDPR)]] and the e-privacy directive oblige you to display a privacy notice containing specific elements on your system. Failure to do so can result in fines.
 +
[[File:Signup-privacy.png|thumb|none|800px|If you attach a privacy policy to a signup page. Anyone attempting to register will have to accept the policy before they can gain access to the system. ]]
 +
You can create a '''Privacy Policy''' for your system by going to the '''Menu Icon''' > '''Global Settings''' > '''Security''' Tab > '''Privacy and Security Policies''' link.
 +
You might consider starting by creating a policy without any role or country permissions, allowing users who haven't signed in or don't yet exist in the system to view the policy from the signup page. Alternatively, you can attach a privacy policy to the login page so that users see it upon their first login, depending on their roles and country. Once the policy is created and activated, you can attach it to the user signup page by selecting the policy in the '''Attach Policies''' input field.
  
[[File:Signup-privacy.png|thumb|none|800px|If you attach a privacy policy to a signup page. Anyone attempting to register will have to accept the policy before they can gain access to the system. ]]
+
==Modifying the Duplicate Check settings==
 +
By default, '''Email''' is used as a unique identifier of users in the system and '''Name''' is used for organizations.
  
You can create a '''privacy policy''' for your system by going to the '''Menu''' Icon > '''Global Settings''' > '''Security''' Tab > '''Privacy and Security Policies''' link. We suggest you start by creating a policy for the '''Default Country''' and '''Languages''' of your choice. The default country is displayed until the user has logged in, at which point the system shows you the policy for the country you have chosen as your primary residence. We also suggest you '''Enforce User Acceptance''' by selecting a date on your privacy policy. Once you have a privacy policy created, go to the desired user signup page and select the desired policy from the '''Attach Policies''' dropdown. Then, '''Save''' your signup page. Now, when anyone is sent to your signup page, they will first be required to read and accept your privacy policy before they can register and gain access to your system.
+
If a user tries to enter an email that is already in the system, it will be flagged as a possible duplicate and prevent the user from registering with the same email twice.
 +
Optionally, you can conduct a duplicate check on multiple fields. It is important to note that when you add multiple fields in one '''Duplicate Check Field''' input, it will utilize the Boolean operator AND instead of the OR operator. For example, if you chose email and first name, it will only flag users that have the same email and first name as an existing user in the system.
  
==Modifying the Duplicate Check settings==
+
To add multiple fields using the Boolean operator OR, select the '''Add Duplicate Check Condition''' button, signified by the plus sign. In that case, duplicates will be flagged if either criterion is met independently.
Choose a uniquely identifiable field, such as the user’s email. If a user tries to enter an email that is already in the system, it will be flagged as a possible duplicate and prevent the user from registering twice with the same email. Optionally, you can conduct a duplicate check on multiple fields. It is important to note that when you add multiple fields in one '''Duplicate Check Field''' box, it will utilize the [[Boolean Operators|Boolean operator]] '''AND''' instead of the '''OR''' operator. For example: if you chose '''email''' and '''first name''', it will only flag users that have the same '''email''' ''and'' '''first name''' as an existing user in the system (as opposed to flagged an existing user that may have the same email ''or'' first name). To add multiple fields using the [[Boolean Operators|Boolean operator]] '''OR''', select the '''Add Duplicate Check Condition''' button, signified by the plus sign. In that case, duplicates will be flagged if either criteria is met independently.
 
  
By default, '''Email''' is typically used as a unique identifier of users in the system and '''Name''' is used for organizations.
+
Optionally you can change the uniquely identifiable field such as email to another field such as employee number.
  
 
=Configuration - Advanced=
 
=Configuration - Advanced=
==Creating Multiple language signup pages==
+
==Creating Multiple Language Signup Pages==
 
Once you have created a signup page you can enter translations for each language you desire.
 
Once you have created a signup page you can enter translations for each language you desire.
  
Line 121: Line 137:
 
# Click '''Save'''.
 
# Click '''Save'''.
  
The translations of custom and standard field captions are pulled from those fields and can be entered in those fields or via an import.
+
The translations of custom and standard field captions are pulled from those fields and can be entered in those fields. If you need to update many custom field translations you may wish to utilize the user custom field import feature.
  
Once translations have been entered and saved on the signup page, you can send your users directly to the signup page in the language you desire. Do so by adding '''&tid=14''' to the end of the signup page URL. Where the number equals the desired language ID. In this case, the language ID 14 will bring the user to the signup page translated into Spanish.
+
Once translations have been entered and saved on the signup page, you can send your users directly to the signup page in the language desired. Do so by adding <code>&tid=14</code> to the end of the signup page URL, where the number equals the desired language ID. In this case, the language ID 14 will bring the user to the signup page translated into Spanish.
  
 
The user can also switch languages on the signup page by using the drop down language menu in the top right of the header.
 
The user can also switch languages on the signup page by using the drop down language menu in the top right of the header.
  
Note: when you switch languages, the signup page will reload and clear any data entered into the fields.
+
<u>'''Note:'''</u> When you switch languages, the signup page will reload and clear any data entered into the fields.
  
==Creating a routing page==
+
==Creating a Routing Page==
 
: ''Main Article: [[Login_Page|Login Page]]''
 
: ''Main Article: [[Login_Page|Login Page]]''
 
Routing pages are created to direct the user to the appropriate signup page in the desired language. Typically, the user clicks a button on the login page that takes them to an intermediary page where they can see the list of available signup pages. You can create a routing page by going to '''Menu''' Icon > '''Global Settings''' > '''Branding''' tab > '''Login Pages''' link > edit the desired login page > '''Routing Page''' tab.
 
Routing pages are created to direct the user to the appropriate signup page in the desired language. Typically, the user clicks a button on the login page that takes them to an intermediary page where they can see the list of available signup pages. You can create a routing page by going to '''Menu''' Icon > '''Global Settings''' > '''Branding''' tab > '''Login Pages''' link > edit the desired login page > '''Routing Page''' tab.
 
[[File:Singup-routing.png|thumb|none|800px|The routing page takes users to the signup page that is right for them.]]
 
[[File:Singup-routing.png|thumb|none|800px|The routing page takes users to the signup page that is right for them.]]
If you paste the '''Page URL''' of your signup page into a routing page, make sure you use the relative path. Example:
+
Use the URL lookup button and select the "Signup Page" option to populate the signup page link into the routing page. Note if you choose to paste a URL here instead use the relative path. Example:
<pre>/s_csignup.jsp?token=XVtQHUUGYVpQRhRRXxNRS1BWZEl2HnFsFA%3D%3D&ptoken=XVtQC1oGYVpQRhRRXxNRS1BWZEl2HnFsFQ%3D%3D
+
<pre>/s_csignup.jsp?token=XVtQHUUGYVpQRhRRXxNRS1BWZEl2HnFsFA%3D%3D&ptoken=XVtQC1oGYVpQRhRRXxNRS1BWZEl2HnFsFQ%3D%3D</pre>
</pre>
 
  
 
Relative paths will resolve correctly and work on production as well as development and backup systems.
 
Relative paths will resolve correctly and work on production as well as development and backup systems.
  
Also make sure you include the desired language ID. Example: '''&tid=14''' will display the Spanish translations.
+
Make sure you include the desired language ID. Example: <code>&tid=14</code> to display the Spanish translation.
  
==Creating an organization lookup style signup page==
+
==Creating an Organization Lookup Signup Page==
 
Reduce the amount of duplicate organizations in your system by using an organization lookup signup page.
 
Reduce the amount of duplicate organizations in your system by using an organization lookup signup page.
  
Line 150: Line 165:
 
Typically, you will not want a list of all organizations you deal with exposed to the public, so on the configuration page you can filter the list of available organizations by organization category and status. This way new users will only be able to search and create themselves under a subset of organizations in your system.
 
Typically, you will not want a list of all organizations you deal with exposed to the public, so on the configuration page you can filter the list of available organizations by organization category and status. This way new users will only be able to search and create themselves under a subset of organizations in your system.
  
You may also want to consider adding a vetting process utilizing workflows and users’ statuses before giving users who self-register under and existing organization full access to the system.
+
You may also want to consider adding a vetting process utilizing workflows and the users’ status before giving users who self-register under an existing organization full access to the system.
  
From the user perspective a new user goes to the desired signup page and then starts typing the name of their organization and they will see a list of organizations meeting that criteria. Once the user selects the desired organization, they enter their user information, and upon submission, the user is created under the chosen organization and the user would need to activate themselves as usual.
+
From the user perspective a new user goes to the desired signup page and then starts typing the name of their organization and they will see a list of organizations meeting that criteria. Once the user selects the desired organization, they enter their user information, and upon submission, the user is created under the chosen organization. Note the user would still need to activate themselves as usual.
  
===How to setup an organization lookup signup page===
+
===How to Set up an Organization Lookup Signup Page===
 
# Setup a user signup page as per above.
 
# Setup a user signup page as per above.
 
# Setup an organization signup page as per above.
 
# Setup an organization signup page as per above.
 
# On the organization signup page, select the user signup page as per above.
 
# On the organization signup page, select the user signup page as per above.
# For the '''Selected fields''' on the Organization signup page, you only need the '''Name''' field.
+
# For the '''Selected Fields''' on the organization signup page, you only need the '''Name''' field.
# For '''Verification Service''' under '''Verification Settings''' choose '''Internal Organization lookup'''.
+
# For the '''Verification Service''' dropdown under the "Verification Settings" section, select "Internal Organization Lookup".
 
# Choose the desired '''Lookup Category''' and '''Lookup Status''' of organization you want users to be able to see and select. For example: you may only want organizations in the category of "Non-profit" and status of "Active" to appear in the list of organizations the user can attach themselves to.
 
# Choose the desired '''Lookup Category''' and '''Lookup Status''' of organization you want users to be able to see and select. For example: you may only want organizations in the category of "Non-profit" and status of "Active" to appear in the list of organizations the user can attach themselves to.
# Scroll up to the '''Signup page Content''' and modify the '''Instructions Content''' as desired. You may want to add something like '''Start typing the name of your organization and select it from the list. Fields marked with a red asterisk (*) are required. If you need assistance contact Fake@fake.fake.'''
+
# Scroll up to the "Signup Page Content" section and modify the '''Instructions Content''' field as desired. You may want to add something like "Start typing the name of your organization and select it from the list. Fields marked with a red asterisk (*) are required. If you need assistance contact fake@fake.fake."
 
# Click '''Save'''.
 
# Click '''Save'''.
  
==Using external verification services in your signup page==
+
==Using External Verification Services on Your Signup Page==
You can create a signup page that will confirm an organization’s charity status by selecting an organization based on a 3rd party database prior to registering that organization in your system.
+
You can create a signup page that will confirm an organization’s charity status by selecting an organization based on a third-party database prior to registering that organization in your system.
  
 
The information from the selected database such as '''Name''', '''City''' and '''State''' is used to populate the organization signup page fields.
 
The information from the selected database such as '''Name''', '''City''' and '''State''' is used to populate the organization signup page fields.
  
If the desired organization cannot be found in the 3rd party database (example it was added after the most recent update), you can provide a link to another signup page where that organization could still register.
+
If the desired organization cannot be found in the third-party database (Example: It was added after the most recent update), you can provide a link to another signup page where that organization could still register.
  
  
Line 180: Line 195:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
||Verification Service
+
||'''Verification Service'''
||Description
+
||'''Description'''
||Update Frequency
+
||'''Link to Data'''
 +
||'''Update Frequency'''
 
|-
 
|-
 
||ABN
 
||ABN
||The Australian Business Number lookup contains a list of businesses that have registered with the Australian Business Register.
+
||The Australian Business Number (ABN) lookup contains a list of businesses that have registered with the Australian Business Register.
https://abr.business.gov.au/
+
||[https://abr.business.gov.au/ ABN Lookup]
 
||Real Time
 
||Real Time
 
|-
 
|-
 
||CRA
 
||CRA
 
||The Canada Revenue Agency (CRA) lookup contains a list of T3010 Registered Charities.
 
||The Canada Revenue Agency (CRA) lookup contains a list of T3010 Registered Charities.
https://www.canada.ca/en/revenue-agency/services/charities-giving/list-charities/downloading-instructions.html
+
||[https://www.canada.ca/en/revenue-agency/services/charities-giving/list-charities/downloading-instructions.html CRA Data]
 
||Monthly
 
||Monthly
 
|-
 
|-
 
||CC
 
||CC
||The Charity Commission GOV.UK lookup contains a list of registered charities in England and Wales.
+
||The Charity Commission for England and Wales (CC) lookup contains a list of registered charities. 
http://data.charitycommission.gov.uk/
+
||[https://register-of-charities.charitycommission.gov.uk/ CC Data]
 +
||Monthly
 +
|-
 +
||CH
 +
||United Kingdom Companies House (CH) contains a list of registered UK companies. 
 +
||[https://www.gov.uk/government/organisations/companies-house CH Data]
 
||Monthly
 
||Monthly
 
|-
 
|-
 
||CRO
 
||CRO
||The Companies Registration Office Ireland (CRO) is the central repository of public statutory information on Irish companies and business names.
+
||The Companies Registration Office Ireland (CRO) is the central repository of public statutory information on Irish companies and business names. 
https://www.cro.ie/Services/Access-to-CRO-Data
+
||[https://www.cro.ie/Services/Access-to-CRO-Data CRO Data]
 
||Real Time
 
||Real Time
 
|-
 
|-
 
||IRS
 
||IRS
||The Internal Revenue Service (IRS) and Internal Revenue Service via Charity Navigator (IRS) lookup contains a list of 501(c)(3) and other charitable organizations.
+
||The Internal Revenue Service (IRS) lookup contains a list of 501(c)(3) and other charitable organizations. 
https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf
+
||[https://www.irs.gov/charities-non-profits/exempt-organizations-business-master-file-extract-eo-bmf IRS Data]
 
||Monthly
 
||Monthly
 
|-
 
|-
 
||NCES
 
||NCES
||The National Center for Education Statistics lookup contains Public Elementary/Secondary School database of all public elementary and secondary schools in the US.
+
||The National Center for Education Statistics (NCES) lookup contains data for all public elementary and secondary schools in the US. 
https://nces.ed.gov/ccd/pubschuniv.asp
+
||[https://nces.ed.gov/ccd/files.asp NCES Data]
 
||Annually
 
||Annually
 
|}
 
|}
  
===How to setup a signup page that uses an external verification service===
+
===How to Set up a Signup Page That Uses an External Verification Service===
Generally, you set up each verification service in a similar way. Below is how you setup a signup page using the IRS verification option via Charity Navigator. Before you begin, you need to setup a custom field to hold the '''Employer Identification Number''' (EIN) value. The EIN is a Federal Tax Identification Number, it is a unique nine-digit number assigned by the '''Internal Revenue Service''' (IRS) to business entities operating in the United States.
+
Generally, you set up each verification service in a similar way. Below is how you setup a signup page using the IRS verification option. Before you begin, you need to setup a custom field to hold the '''Employer Identification Number''' (EIN) value. The EIN is a Federal Tax Identification Number, it is a unique nine-digit number assigned by the '''Internal Revenue Service''' (IRS) to business entities operating in the United States. Other verification services will have a different identification number.
  
 
# If you do not already have a custom field to hold the EIN number, create a '''Text Box - Text Single Line''' custom field in the organization custom fields, and permission this field to be available as desired.
 
# If you do not already have a custom field to hold the EIN number, create a '''Text Box - Text Single Line''' custom field in the organization custom fields, and permission this field to be available as desired.
Line 222: Line 243:
 
# Setup an organization signup page the same way as above.
 
# Setup an organization signup page the same way as above.
 
# On the organization signup page select the desired user signup page as per above.
 
# On the organization signup page select the desired user signup page as per above.
# In the '''Input Form''' section drag and drop the EIN custom field we created earlier from the '''Available Fields''' to the '''Selected Fields'''. This custom field is required in order to use the IRS verification feature.
+
# In the '''Input Form''' section drag and drop the EIN custom field you created from the '''Available Fields''' to the '''Selected Fields'''. You must add a custom field for this number in order to use the IRS verification feature.
# For '''Verification Service''' select '''Internal Revenue Service via Charity Navigator'''.
+
# For '''Verification Service''' select '''United States Internal Revenue Agency (IRS)'''.
 
# Click '''Sample Instructions''' for both '''Search Instructions''' and '''Result Instructions'''.
 
# Click '''Sample Instructions''' for both '''Search Instructions''' and '''Result Instructions'''.
 
# For '''Additional Automatic Field Population''' click the '''Add Mapping Field''' button that looks like a plus sign to create a new row.
 
# For '''Additional Automatic Field Population''' click the '''Add Mapping Field''' button that looks like a plus sign to create a new row.
# From the '''Mapping Field''' column drop down, select '''Lookup Field ID (EIN)'''.
+
# From the '''Mapping Field''' column drop down, select '''Registration Number (EIN)'''.
 
# In the '''Custom Field''' input column right beside the mapping field, start typing the name of the EIN field you created and select it from the list.
 
# In the '''Custom Field''' input column right beside the mapping field, start typing the name of the EIN field you created and select it from the list.
 
# Click '''Save'''.
 
# Click '''Save'''.
Line 233: Line 254:
 
You can attach an existing workflow to a signup page using the '''Attach Workflow''' setting. You can create '''Workflows''' under the '''Menu''' Icon > '''Workflows'''. Workflows on signup pages are typically used to to notify someone that a new user has registered and or some action needs to be taken such as an approval and/or to automatically run some tasks upon signup.
 
You can attach an existing workflow to a signup page using the '''Attach Workflow''' setting. You can create '''Workflows''' under the '''Menu''' Icon > '''Workflows'''. Workflows on signup pages are typically used to to notify someone that a new user has registered and or some action needs to be taken such as an approval and/or to automatically run some tasks upon signup.
  
==How to set up an eligibility questionnaire==
+
==How to Set up an Eligibility Questionnaire==
If there are criteria that would render an applicant ineligible to gain access to your system, you may want to setup an eligibility questionnaire that a user must fill in before you let the user register. This is typically done with a Universal Tacking Application (UTA). In the UTA, ask any questions that would cause an applicant to be ineligible. Example: If you don't fund religious organizations or organizations in a specific area, ask applicants these question before you allow them to register. If the applicant meets your desired criteria, you send them on to the desired signup page. If they fail your criteria, you send them to a page letting them know they are ineligible. Using this method saves the user time by letting them know up front if they are not going to be given access and it saves you time by reducing the number of users created in your system.
+
If there are criteria that would render an applicant ineligible to gain access to your system, you may want to setup an eligibility questionnaire that a user must fill in before you let the user register. This is typically done with a Universal Tacking Application (UTA). In the UTA, ask any questions that would cause an applicant to be ineligible. For example, if you don't fund religious organizations or organizations in a specific area, ask applicants these question before you allow them to register. If the applicant meets your desired criteria, then give them a link to the desired signup page. If applicant fails your criteria, then let them know they are ineligible. Using this method saves the user time by letting them know up front if they are not going to be given access and it saves you time by reducing the number of users created in your system.
  
==Other vetting processes==
+
==Other Vetting Processes==
 
Some organizations require users and organizations to be manually vetted or approved before the user gains access. This is typically done by using the User/Organization '''status''' in conjunction with workflows to notify the appropriate internal staff.
 
Some organizations require users and organizations to be manually vetted or approved before the user gains access. This is typically done by using the User/Organization '''status''' in conjunction with workflows to notify the appropriate internal staff.
  
Line 246: Line 267:
 
https://www.treasury.gov/about/organizational-structure/offices/Pages/Office-of-Foreign-Assets-Control.aspx
 
https://www.treasury.gov/about/organizational-structure/offices/Pages/Office-of-Foreign-Assets-Control.aspx
  
==How to delete/purge your information==
+
==How to Delete/Purge Your Information==
 
When users sign up to gain access to your system, they provide you with Personal Identifiable Information (PII). We suggest you provide your users with information of who they should contact in regards to purging or deleting any personal information held within your system.
 
When users sign up to gain access to your system, they provide you with Personal Identifiable Information (PII). We suggest you provide your users with information of who they should contact in regards to purging or deleting any personal information held within your system.
  
Line 253: Line 274:
 
Some organizations will set up data retention policies to remove PII after a set period of time, whereas other organizations may remove PII upon request. Either way, you should provide some way to contact someone acting as a privacy officer within your organization in regards to any privacy concerns from your users.
 
Some organizations will set up data retention policies to remove PII after a set period of time, whereas other organizations may remove PII upon request. Either way, you should provide some way to contact someone acting as a privacy officer within your organization in regards to any privacy concerns from your users.
  
==How to enable/disable CAPTCHA==
+
==CAPTCHA==
CAPTCHA stands for “Completely Automated Public Turing Test to tell Computers and Humans Apart”. CAPTCHA is used to minimize the occurrence of spam records being submitted via bots. Toggling this setting on may reduce the amount of spam you receive, but it will not block all spam from bots. Note: there is some debate over the usability and accessibility of CAPTCHA and reCAPTCHA, especially among people with disabilities.
+
CAPTCHA (which stands for "Completely Automated Public Turing Test to tell Computers and Humans Apart") is used to minimize the occurrence of spam records being submitted via bots. CAPTCHA will reduce the amount of spam you receive, but it will not block all spam from bots.
 +
 
 +
CAPTCHA settings can be found at '''Menu''' icon > '''Global Settings''' > '''Security''' tab.
  
CAPTCHA is on by default, but you may want to be judicious in its adoption.
 
  
You can toggle the CAPTCHA on or off for your entire system by going to '''Menu''' icon > '''Global Settings''' > '''Security''' tab > '''Global CAPTCHA Settings''' and choose either '''Enabled''' or '''Disabled'''. If you choose '''Inherit''', you can specify which signup pages will have a CAPTCHA via their configuration pages.
 
  
 
===CAPTCHA Alternatives===
 
===CAPTCHA Alternatives===
You can also use an alternative to Google's reCAPTCHA for users in countries that are unable to communicate with Google servers due to government policy. To set this up, go to '''Global Settings''' > '''Security''' tab and scroll down to see the '''System Security''' section to see options for alternative CAPTCHA services. Type in the name of relevant counties.
+
By default, systems use Google reCAPTCHA. For users in countries that are unable to communicate with Google servers due to government policy, you may wish to enable the alternate CAPTCHA.
 +
 
 +
Alternate CAPTCH can be used by typing the country name into the input called '''Countries Using Alternate CAPTCHA Service'''.
  
 
[[File:CAPTCHA-Alternatives.png|thumb|none|500px|Set <strong>Countries Using Alternate CAPTCHA Service</strong> to a list of relevant countries .]]
 
[[File:CAPTCHA-Alternatives.png|thumb|none|500px|Set <strong>Countries Using Alternate CAPTCHA Service</strong> to a list of relevant countries .]]
  
==Tip: Keep signup pages short==
+
==How to Test Signup Pages==
 +
Signup pages must be activated before they can be previewed and tested. To test a page, do the following:
 +
 
 +
# Go to the signup page settings and scroll to the "Activation and Security" section.
 +
# Ensure the '''Activate Page''' Toggle is enabled and click '''Save'''.
 +
# Under the "Activation and Security" section, copy the URL populating the '''Standard''' field.
 +
# In the Google Chrome browser paste the URL into the address bar of a new incognito mode tab and press enter. This will display a preview of your signup page.
 +
# To test the page, simply complete the appropriate details and submit the form. If successful, a confirmation message will be displayed.
 +
# The submitted user/organization will be listed under the associated organization in the '''Organization Hierarchy''' chart. Go to '''Menu Icon''' > '''Organization Hierarchy''' > External tab to view the newly created organization and or user.
 +
 
 +
==Tip: Keep Signup Pages Short==
 
- Don’t ask every question you think you need upfront on the signup page. Once a user has registered and logged into the system, you can ask them more questions as part of your process.
 
- Don’t ask every question you think you need upfront on the signup page. Once a user has registered and logged into the system, you can ask them more questions as part of your process.
  
- The shorter your signup page, the greater your completion rate will be, so ask the minimum amount of questions possible. Go through each question and ask yourself: why are we collecting this information, and how are we using it now?
+
- The shorter your signup page, the greater your completion rate will be, so ask the minimum amount of questions possible. Go through each question and ask yourself: why are we collecting this information, and how are we using it?
  
 
- Have someone else fill in your form and look critically at how they answered. Did they answers the way you expected? Do you need to revise the question or provide instructions to ensure you get desired responses?
 
- Have someone else fill in your form and look critically at how they answered. Did they answers the way you expected? Do you need to revise the question or provide instructions to ensure you get desired responses?
  
- If a question is not marked mandatory, do you still need to ask it and when do you need to ask it?
+
- If a question is not marked mandatory, do you still need to ask it? and if so when do you need to ask it?
  
 
=Settings Explained=
 
=Settings Explained=
Line 283: Line 316:
 
!|Setting
 
!|Setting
 
!|Description
 
!|Description
 +
|-
 +
||Signup Page Name
 +
||Use to differentiate signup pages.
 
|-
 
|-
 
||Associated Organization
 
||Associated Organization
||Determines where the users and organizations created will reside in your organization hierarchy. Typically, you would create an organization in the external organization hierarchy and call it something like “Web Registrants”.
+
||Determines where the users and organizations created will reside in your organization hierarchy. Typically, you would create an organization in the external organization hierarchy and call it something like “Web Registrants”. Note container organizations should be flagged as such.
 
|-
 
|-
 
||Description
 
||Description
||This input is not seen by your applicants but it is important as it is the only way you can tell user signup pages apart when you are picking a user signup page from the organization signup configuration page. You may also wish to add special instructions or notes for other administrators in this field.
+
||This input is not seen by your applicants but is used to differentiate signup pages when you are picking a user signup page from the organization signup configuration page. You may also wish to add special instructions or notes for other administrators in this field.
 
|}
 
|}
 
  
 
===Activation & Security===
 
===Activation & Security===
Line 300: Line 335:
 
||Activate Page
 
||Activate Page
 
||The signup page will only be accessible if this setting is toggled on. If this setting is toggled off and a user navigates to this signup page they will receive an error message asking the user to contact your system administrator.
 
||The signup page will only be accessible if this setting is toggled on. If this setting is toggled off and a user navigates to this signup page they will receive an error message asking the user to contact your system administrator.
|-
 
||Enable CAPTCHA Validation
 
||Toggling this setting on will enable CAPTCHA validation on this signup page. This is only the case if the Global CAPTCHA Validation is set to '''Inherit''' in the [[Security Settings|Global Security Settings]]. CAPTCHA is used to minimize the occurrence of spam records being submitted via bots. Toggling this setting on may reduce the amount of spam you receive, but it will not block all spam from bots.
 
 
|-
 
|-
 
||Enable Field Security Token
 
||Enable Field Security Token
Line 321: Line 353:
 
|-
 
|-
 
||Duplicate Check Field
 
||Duplicate Check Field
||Select one or more fields to be used by the duplicate check. Typically, '''Email''' is used for users and '''Name''' is used for organizations. If you choose to check on more than one field the operation used is '''AND'''. For example: if you chose email and first name, it will only flag users that have the same email and first name. Support for '''OR''' is planned for the November 2020 upgrade.
+
||Select one or more fields to be used by the duplicate check. Typically, '''Email''' is used for users and '''Name''' is used for organizations. If you choose to check on more than one field the operation used is '''AND'''. For example: if you chose email and first name, it will only flag users that have the same email and first name. If you want to use '''OR''' you must click the '''Add Duplicate Check Condition''' button.
 
|-
 
|-
||Form Submission Behavior (User Signup)
+
||Form Submission Behavior
||This setting is only found on the User Signup page. Typically, you will choose '''Only create new users'''. The three available settings are:
+
||On the User Signup page. Most people use the default '''Create new user only if no existing match found'''. On the organization signup page. Most people use the default '''Create new organization only if no existing match found'''
* '''Create new or update matching user''' - is not recommended as it allow the direct update of users when existing duplicate matches are found, or create new users when no match is found.
 
* '''Only create new user''' – Is recommended and Only creates a user as new when no existing duplicate match is found. No updates are made to contacts when existing duplicate users are found.
 
* '''Always create new user''' – is not recommended and will always create a user as new, regardless of whether any existing duplicate match is found.
 
 
 
 
|-
 
|-
 
||Duplicate Restriction Message
 
||Duplicate Restriction Message
Line 337: Line 365:
 
|-
 
|-
 
||User Signup
 
||User Signup
||Only available on the organization signup page. Choose between '''Single User''' which will create 1 user along with the organization or '''Multiple Users''' which can create multiple sets of users along with the organization.
+
||Only available on the organization signup page. Choose between '''Single User''' which will create one user along with the organization or '''Multiple Users''' which can create multiple sets of users along with the organization.
 
|-
 
|-
 
||User/Multiple User Signup Page
 
||User/Multiple User Signup Page
||Select the user signup page(s) you want to attach to the Organization signup page. The User signup page, will show up inside the organization signup page in its own section that appears under the organization details section.
+
||Only available on the organization signup page. Select the user signup page(s) you want to attach to the Organization signup page. The User signup page, will show up inside the organization signup page in its own section that appears under the organization details section.
|-
 
||Form Submission Behavior (Organization Signup)
 
||Only available on the organization signup page. Typically, only '''Create new organization, block submission if matching organization found''' is recommended. The options are:
 
* '''Create new organization, update if matching organization found''' - This setting is not recommended. Allows the direct update of organizations when existing duplicate matches are found, or create new organization when no match is found.
 
* '''Create new organization, block submission if matching organization found''' - This is the default setting. It only allows the creation of organizations as new when no existing duplicate match is found. No updates are made to either organizations or contacts when existing duplicate organizations are found.
 
* '''Create new organization regardless of matching organization found''' - This setting will always create an organization as new, regardless of whether any existing duplicate match is found.
 
* '''Create new organization, if matching organization exists, only update users''' – This setting allows you to create a new organization or create a new contact under an existing organization. No updates are made to either organizations or contacts when existing duplicate organizations are found.
 
* '''Create new organization, if matching organization exists, show entries to select, with option to create new''' - This setting allows you to create a new organization or create a new contact under an existing organization. When duplicate organizations are found, allow for the selection of a duplicate organization, and also allow an option to force create a new organization.
 
 
 
 
|-
 
|-
 
||SmartCheck Validation
 
||SmartCheck Validation
Line 355: Line 374:
 
|-
 
|-
 
||Attach Workflow
 
||Attach Workflow
||Select the desired workflow you would like to run upon the registration of a new user or organization. Typically, workflows on signup pages notify someone that a new user has registered and or some action needs to be taken or the workflow will run some tasks automatically.
+
||Select the desired workflow you would like to run upon the registration of a new user or organization. Typically, workflows on signup pages notify someone that a new user has registered and or some action needs to be taken or the workflow will run some task automatically.
 
|-
 
|-
 
||Attach Policies
 
||Attach Policies
||Only found on the User Signup page. Select the policy you want users to be forced to accept before they can register. Typically, you would select a privacy policy that details your company’s views and procedures related to the collection of information on people who use your system. This way a new user can see and accept your policies before they enter any personally identifiable information (PII) into your system.
+
||Only found on the User Signup page. Select the policy you want users to be forced to accept before they can register. Typically, you would select a privacy policy that details your company’s views and procedures related to the collection of information on people who use your system. This way a new user can see and accept your policies before they enter any personally identifiable information (PII) into your system. Alternatively you may wish to attach a policy to the login page instead which will be enforced upon the users first login. Note polices attached prior to login cannot include any role our country based permissions.
 
|-
 
|-
 
||Default Country
 
||Default Country
||This setting is used to specify a default country on the signup page. For example, if all applicants registering via this signup page live in the United States, you might choose that option as the default country.
+
||This setting is used to specify a default country on the signup page. For example, if all applicants registering via this signup page live in the United States, you might choose that option as the default country to save users some time.
When the form opens, if the value chosen is United States then that value will automatically be pre-selected in the Country field for the user. The user can still change the Country field value if they wish, but if the user does not, this feature saves the user some time.
+
When the form opens, if the value chosen is United States then that value will automatically be pre-selected in the Country field for the user. The user can still change the Country field value if they wish.
 
|-
 
|-
 
||Default State
 
||Default State
||This setting is used to specify a default State on the signup page. For example, if all applicants registering via this signup page live in New York State, you might choose that option as the default State.
+
||This setting is used to specify a default state or province on the signup page. For example, if all applicants registering via this signup page live in New York, you might choose that option as the default state to save users some time.
When the form opens, if the value chosen is New York then that value will automatically be pre-selected in the State field for the user. The user can still change the State field value if they wish, but if the user does not, this feature saves the user some time.
+
When the form opens, if the value chosen is New York then that value will automatically be pre-selected in the state field for the user. The user can still change the state province field value if they wish.
 +
 
 
|-
 
|-
 
||Default Status
 
||Default Status
Line 375: Line 395:
 
|-
 
|-
 
||Roles
 
||Roles
||Only found on User signup pages. Roles are a way of grouping like users together. We use roles to control what the user can see and do in the system. You can '''Add''' or '''Remove''' roles for Users using this setting.
+
||Only found on User signup pages. Roles are a way of grouping like users together. We use roles to control what the user can see and do in the system. You can '''Add''', '''Remove''' or '''Update''' roles for Users using this setting.
 
|-
 
|-
 
||Page Layout
 
||Page Layout
||This setting controls the layout of the page. '''Default''' is recommended as you will always get the latest and greatest signup page template. If you select Custom you will be able to add the sample template and customize the HTML of the signup page. However, if you select custom, your template will not get updated with future upgrades and as such you may be need to manually update your custom template after future upgrades.
+
||This setting controls the layout of the page. '''Default''' is recommended as you will always get the latest and greatest signup page template. If you select '''Custom''' you will be able to add the sample template and customize the HTML of the signup page. However, if you select custom, your template will not get updated with future upgrades and as such you may be need to manually update your custom template to ensure it continues to work as expected after each upgrade.
 
|}
 
|}
  
Line 392: Line 412:
 
||If you want to add some text such as “registration” into the header beside your logo you can add it here. Typically, this input is left blank.
 
||If you want to add some text such as “registration” into the header beside your logo you can add it here. Typically, this input is left blank.
 
|-
 
|-
||Company Section Title
+
||Company/Contact Section Title
||Only available on the organization signup page. This text will appear above the fields where you enter organization data. Typically, people enter “Organization Information”.
+
||This text will appear above the fields where you enter organization/contact data. Typically, people enter “Organization Information” on the organization signup page and “User Information” on the user signup page.
|-
 
||Contact Section Title
 
||Only available on the user signup page. This text will appear above the fields where you enter user data. Typically, people enter “User Information”.
 
 
|-
 
|-
 
||Instructions Title
 
||Instructions Title
||Text entered here will appear inside the instruction box in blue and above your instructions. Typically, people enter “Registration”.
+
||Text entered here will appear inside the instruction box above your instructions. Typically, people enter “Registration”.
 
|-
 
|-
 
||Instructions Content
 
||Instructions Content
Line 405: Line 422:
 
|-
 
|-
 
||Enable Same Address button
 
||Enable Same Address button
||Toggle on to get a button that will populate the user address fields with the values entered into the Organization address fields. This feature will save users time if they use their organizations address for their user address.
+
||Only found on the Organization signup page with a user signup page attached. Toggle on to get a button that will populate the user address fields with the values entered into the Organization address fields. This feature will save users time if their organizations and user addresses are the same.
 
|-
 
|-
 
||Same Address Button label
 
||Same Address Button label
||Define the caption you would like to see on the same address button. Typically, people enter “Copy Address”.
+
||Define the caption you would like to see on the same address button. The default is “Copy Address”.
 +
|-
 +
||Submit Button Label
 +
||Define the caption you would like to see on the form submission button. 
 +
|-
 +
||Display Login Link on Page
 +
||This setting is used when a user is invited to contribute to an application via a personal email but they already have an existing account under another email they would like to use.
 +
|-
 +
||Enable Email Confirmation
 +
||Only found on the user signup page and typically left disabled. This setting displays an email confirmation field when the email standard field is included on the form.
 
|}
 
|}
  
Line 423: Line 449:
 
|-
 
|-
 
||Confirmation Page Content
 
||Confirmation Page Content
||Smaller text displayed after the user submits the form. Appears under the title. Typically, people enter “Thank you for registering. Activation instructions have been emailed to you.”.
+
||Smaller text displayed after the user submits the form. Appears under the title. Typically, people enter “Thank you for registering. Activation instructions have been emailed to you”.
 
|-
 
|-
||Link text
+
||Link Text
||Text used for a link to the login page so people can log in after registering. Typically, people enter either “log in here” or “Visit youralias.smartsimple.com”.
+
||Text used for a link to the login page so people can log in after registering. Typically, people enter either “Log in here” or “Visit youralias.smartsimple.com”.
 
|-
 
|-
 
||Link URL
 
||Link URL
||Link to login page. typically, people enter “/s_Login.jsp”.
+
||Link to login page. Typically, people enter “/s_Login.jsp”.
 
|}
 
|}
  
Line 480: Line 506:
 
||Additional Automatic Field Population
 
||Additional Automatic Field Population
 
||Only available with IRS verification service. Click the add mapping field button under the mapping field column to add a mapping field. Then select a mapping field from the drop down. Then in the custom field column start typing the caption of the desired custom field, then click it to select that field. Note that the custom field you select must also be in the selected fields list in the Input Form section.
 
||Only available with IRS verification service. Click the add mapping field button under the mapping field column to add a mapping field. Then select a mapping field from the drop down. Then in the custom field column start typing the caption of the desired custom field, then click it to select that field. Note that the custom field you select must also be in the selected fields list in the Input Form section.
|-
 
||Lookup Field ID
 
||Not found on IRS or Internal organization lookups. Enter the custom field ID you want to use for mapping the ABN, CRA, CC, CRO, NCES number to. Enter cf_ then the custom field ID, Example cf_1234567.
 
 
|-
 
|-
 
||Exclude Foundation(s)
 
||Exclude Foundation(s)
||Only available with IRS verification service. Select foundations types you want to exclude from the search, then click the Exclude foundation button which looks like +. Example some people may wish to exclude religious organizations such as churches so they select 10 – Church 170(b)(1)(A)(i) and click exclude foundation button.
+
||Only available with IRS verification service. Select foundations types you want to exclude from the search.
 
|-
 
|-
 
||Exclude Subsection(s)
 
||Exclude Subsection(s)
||Only available with IRS verification service. Select subsections you want to exclude from the search and then click the exclude subsection button looks like a +.
+
||Only available with IRS verification service. Select subsections you want to exclude from the search.
 
|}
 
|}
  
 
==Templates==
 
==Templates==
The following settings are available on the templates tab.
+
The following settings are available on the templates tab if '''Page Layout''' is set to '''Custom'''.
  
The templates tab only appears if you have selected “Custom” for “Page Layout”. This setting allows you to modify the HTML of the signup page and is generally not recommended. If you choose to customize the HTML of your signup page you won’t get the latest and greatest templates and you may be required to update your HTML if changes to templates or functionality occur in an upgrade.
+
The page template allows you to modify the HTML of the signup and confirmation page and is generally not recommended. If you choose to customize the HTML of your signup page you won’t get the latest and greatest templates and you may be required to update your HTML if changes to templates or functionality occur in an upgrade.
  
 
===Signup Page Template===
 
===Signup Page Template===
Line 501: Line 524:
 
===Confirmation Page Template===
 
===Confirmation Page Template===
 
Only available on user signup pages. Click the Sample Template link to add the html of the signup page into the input and then modify as desired.
 
Only available on user signup pages. Click the Sample Template link to add the html of the signup page into the input and then modify as desired.
 
==Classic Options==
 
The settings on the Classic Options tab for signup pages are legacy options slated for deprecation and are no longer used or recommended.
 
  
 
[[Category:Interface]]
 
[[Category:Interface]]

Latest revision as of 16:07, 19 August 2024

Overview

A signup page (also known as a registration page) enables users and organizations to independently register and gain access to your system. It is common to have multiple signup pages depending on the types of people and organizations you want to register. In this article you will learn about the different types of signup pages, how to configure them and related functionality. Global Administrator access is required to create and modify signup pages.

Configuration - Essentials

Creating a Signup Page

The Associated Organization

Before you create a signup page, you will need to decide where the users and organizations you are creating will reside in your organization hierarchy. In other words, when you create a new user or organization via a signup page, where will they be created in your system? Typically, you would create an organization in the external organization hierarchy and call it something like "Web Registrants". Later you would associate that organization with your signup page. Then all new users and organizations created by this specific signup page will be created under that organization.

If you are creating an organization to act structurally like a holding folder rather than a true organization, then you need to flag the organization as such. If you flag an organization as a container, any hierarchy access granted in the security matrix to organizations will not be applied for the container organization.

To flag an organization as a container go to Menu Icon > Organizations > Edit an Organization > Actions > Edit Categories and Access > Toggle on Container.

To set up an organization go to Menu Icon > Organization Hierarchy > Click on the second tab which is the external hierarchy, and click the New button to create a new organization in the external organization hierarchy.

Roles and Categories

Main Articles: User Role & Client Categories

Once you have set up an organization to associate with a signup page, you will need to set up Roles (for users) and Categories (for organizations).

User Roles

Roles are a way of grouping like users together. We use roles to control what the user can see and do in the system. When you create roles, you can indicate if a role is only for internal or external users. For example, typically the "Applicant" role should only be given to external users.

When you create a user via a signup page, you need to give the user one or more roles. Typically, you would give a user a role like "Applicant" or "Reviewer". Before creating your signup page, ensure that you have created the roles you will assign to newly created users. You can setup user roles by going to Menu Icon > Global Settings > Users tab > Roles and click the New Role button.

Organization Categories

Categories are a way of grouping like organizations together and are also used to control what can be seen and done. When you create an organization via a signup page, you need to give the organization one or more categories. Typically, you would give an organization the category of "Grant Seeking Organization" or "External Reviewers".

Before creating your signup page, ensure that you have already created the categories you will assign to newly created organizations. You can set up organization categories by going to Menu Icon > Global Settings > Organization tab > Categories and click the New button.

Statuses

Main Article: Status

Lastly, set up a status for users and organizations. Statuses are like a place in time. For example, you might use a "Newly Registered" status for new registrants, and later once these users are vetted, you might switch them to an “Active” Status and later when you no longer engage with the user you might move them to an “Inactive” status. Before creating your signup page, ensure that you have created the statuses you will assign to newly created users and organizations. You can set up a user status by going to Menu Icon > Global Settings > User or Organization tab > Statuses, and click the New button to create a user or organization status.

Creating a User Signup Page

The user signup page adds or updates individuals within your system. Users created in the system via a signup page typically login and do something in your system, such as applying for or reviewing a grant application.

Sample user signup page

How to Set up a User Signup Page

  1. Go to the Menu Icon > Global Settings > Users Tab > Signup Pages Link.
  2. Click the New Signup Page button in the action bar. It looks like a plus sign.
  3. Enter a name for the signup page that will be used to distinguish it from other pages, but will not be visible to the end user.
  4. Choose an Associated Organization via the lookup. New users will be created under the associated organization. Generally, you want to select an external organization.
  5. Enter a Description. This is not seen by your applicants but it is important as it helps differentiate user signup pages when you are picking a user signup page from the organization signup configuration page.
  6. Change the Access Type to User Access if you want the user to be able to login.
  7. For Roles to Add select the desired roles to be assigned to the user.
  8. Modify the Signup Page Content and Confirmation Page Content as desired. Typically in the instructions you might want to add a phone number or email of who to contact if the user is having trouble registering. On the confirmation page content you might want to add something like "check your email and spam folder in your email for instructions on how to gain access to the system."
  9. Drag and drop the fields from the Available Fields list into the Selected Fields list. These are the fields that will appear on the signup page. Once fields are in the Selected Fields list you may drag and drop fields to reorder them or hover over a field and click the grey x button to remove the field from the list. If you are adding the address fields, typically the country input should appear above the state/province drop down so that the list of states or provinces can be filtered based on the country.
  10. Click Save.

Creating an Organization Signup Page

The organization or company signup page creates organizations within your system.

How to Set up an Organization Signup Page

  1. Go to the Menu Icon > Global Settings > Organizations tab and click on the Signup Pages Link.
  2. Click the New Signup Page button in the action bar. It is signified by a plus sign.
  3. Give the signup page a name.
  4. Choose an Associated Organization via the lookup. New organizations will be created under this organization. Generally, you want to select an external organization.
  5. Optionally, enter a description. This will not be visible to applicants but is important for differentiating organization signup pages. You can include the purpose and usage of the page to make it easier to find and provide context.
  6. For Categories select the categories you want to assign to new organizations created.
  7. Change the signup page and confirmation page content if desired. For example you may want to add something like who the user should contact if they need assistance. If a user signup page is attached to an organization signup page, the confirmation page content of the user signup page will be used and the organization confirmation page content will be ignored.
  8. Drag and drop the fields from the Available Fields list into the Selected Fields list. These fields will appear on the organization signup page. Fields in the Selected Fields List may be reordered using drag and drop. If you are adding the address fields, typically the country input should appear above the state/province drop down so that the list of states or provinces can be filtered based on the country.
  9. Click Save.

Creating a Combined User and Organization Signup Page

Typically, you will want to create an organization and one or more users at the same time.

A signup page that creates a single organization and single user at the same time.

You can create signup page that will create one or more users and organization at the same time by:

  1. Create a user signup page as above.
  2. Create an organization signup page as above.
  3. Edit the organization signup page, and for the setting called User Signup select either Single User or Multiple Users.
  4. If you picked Single User you will see a User Signup Page setting. Click the drop down and select the desired user signup page. Having a unique description on the user signup page will help make selection easy.
  5. (Optional) Toggle on Enable Same Address Button if you want the user’s address to be pre-populated with the address of the organization so the user does not need to enter the same address twice.
  6. Click Save.

Note: When you choose a user signup page, it will show up inside the organization signup page in its own section under the organization details. Also note that when a user signup page is attached, the user signup confirmation page is used. Therefore, if you want to make changes to the confirmation page that appears to the user upon submission, you will need to navigate the user signup page instead.

A signup page that creates a single organization and multiple users at the same time. In this example the Lead Applicant is set to a minimum of 1 so they are required. The co-applicant is set to a minimum of 0 and maximum of 3 so none or up to 3 co-applicants can register at the same time.

If you chose Multiple Users for the User Signup setting, you will be able to create an organization with more than one user signup as well as more than one set of users.

In this scenario you will see a setting called Multiple User Signup.

Click the Add Signup Page button to add multiple user signup pages. You can specify a minimum and maximum number of users you want to create per attached signup page as well as specify section and user titles.

Note: Depending on your jurisdiction, be aware that enabling multiple users means you are asking someone to enter personally identifiable information on behalf of another person, which may not comply with certain regulations.

Making Changes to Fields on Your Signup Page

Let’s say you want to make the Email field on your user signup page mandatory. Navigate to the User standard field for email: Menu Icon > Global Settings > Users Tab > Standard Fields link and edit the Email standard field by toggling on the Mandatory setting. Now when you go back to the signup page and preview it, you will see the email field is now set to mandatory and the relevant validation was automatically added.

Any changes you make to any fields that are included on a signup page will be updated instantaneously on your signup pages. You can also go back to the signup page at any time to change the order of fields and add or remove fields by modifying the selected fields. To remove a field, hover over the desired field and click the button marked with an x. Drag and drop Selected Fields to modify the order in which the fields will appear on the signup page.

Modifying the New User Email Template

New users who can log in will receive an email containing an activation link. To enable this, the signup page must have the Access Type set to User Access.

The email the user receives by default is configured globally and is located at Menu Icon > Global Settings > Security Tab > Password and Activation Policies > Activation Emails in the left navigation. Once you add the sample template you can modify it as needed. The sample template will send the new registrant a link where they can enter their desired password to complete user activation. The variable for this is:

https://@url@@activationlink@

If you want a custom new user email sent to users who register through this specific signup page only, instead of using the global template, then, on that particular signup page, go to the Templates tab and add the sample template and fill in the other fields. The New User Email Template on the signup page takes precedence over the New User general template found under Global Settings. Typically, we recommend that you leave the Template tab New User Email Template empty and use the global template instead.

Setting Up Privacy Policies

Main Article: Privacy and Security Policies

A privacy policy details your company’s views and procedures related to the collection of information on people who use your system. It's important to let your users know how you are going to use the information you are requesting, and to tell users who to contact should they have questions. In some jurisdictions, such as California, you are required to post your privacy policy by law. In the EU, the General Data Protection Regulation (GDPR) and the e-privacy directive oblige you to display a privacy notice containing specific elements on your system. Failure to do so can result in fines.

If you attach a privacy policy to a signup page. Anyone attempting to register will have to accept the policy before they can gain access to the system.

You can create a Privacy Policy for your system by going to the Menu Icon > Global Settings > Security Tab > Privacy and Security Policies link. You might consider starting by creating a policy without any role or country permissions, allowing users who haven't signed in or don't yet exist in the system to view the policy from the signup page. Alternatively, you can attach a privacy policy to the login page so that users see it upon their first login, depending on their roles and country. Once the policy is created and activated, you can attach it to the user signup page by selecting the policy in the Attach Policies input field.

Modifying the Duplicate Check settings

By default, Email is used as a unique identifier of users in the system and Name is used for organizations.

If a user tries to enter an email that is already in the system, it will be flagged as a possible duplicate and prevent the user from registering with the same email twice. Optionally, you can conduct a duplicate check on multiple fields. It is important to note that when you add multiple fields in one Duplicate Check Field input, it will utilize the Boolean operator AND instead of the OR operator. For example, if you chose email and first name, it will only flag users that have the same email and first name as an existing user in the system.

To add multiple fields using the Boolean operator OR, select the Add Duplicate Check Condition button, signified by the plus sign. In that case, duplicates will be flagged if either criterion is met independently.

Optionally you can change the uniquely identifiable field such as email to another field such as employee number.

Configuration - Advanced

Creating Multiple Language Signup Pages

Once you have created a signup page you can enter translations for each language you desire.

The language picker as it appears on a signup page.
The button used to enter translations on a signup page.

To enter a translation on a signup page

  1. Click on the Signup Page Translation Settings button in the action bar.
  2. Select the desired language.
  3. Enter the translations desired into the appropriate fields.
  4. Click Save.

The translations of custom and standard field captions are pulled from those fields and can be entered in those fields. If you need to update many custom field translations you may wish to utilize the user custom field import feature.

Once translations have been entered and saved on the signup page, you can send your users directly to the signup page in the language desired. Do so by adding &tid=14 to the end of the signup page URL, where the number equals the desired language ID. In this case, the language ID 14 will bring the user to the signup page translated into Spanish.

The user can also switch languages on the signup page by using the drop down language menu in the top right of the header.

Note: When you switch languages, the signup page will reload and clear any data entered into the fields.

Creating a Routing Page

Main Article: Login Page

Routing pages are created to direct the user to the appropriate signup page in the desired language. Typically, the user clicks a button on the login page that takes them to an intermediary page where they can see the list of available signup pages. You can create a routing page by going to Menu Icon > Global Settings > Branding tab > Login Pages link > edit the desired login page > Routing Page tab.

The routing page takes users to the signup page that is right for them.

Use the URL lookup button and select the "Signup Page" option to populate the signup page link into the routing page. Note if you choose to paste a URL here instead use the relative path. Example:

/s_csignup.jsp?token=XVtQHUUGYVpQRhRRXxNRS1BWZEl2HnFsFA%3D%3D&ptoken=XVtQC1oGYVpQRhRRXxNRS1BWZEl2HnFsFQ%3D%3D

Relative paths will resolve correctly and work on production as well as development and backup systems.

Make sure you include the desired language ID. Example: &tid=14 to display the Spanish translation.

Creating an Organization Lookup Signup Page

Reduce the amount of duplicate organizations in your system by using an organization lookup signup page.

User begins typing the name of their organization and if that organization exists in your system, the user can select that organization and attach themselves to that organization.

The organization lookup signup page gives new users the ability to sign up under an existing organization. This can be achieved by allowing new users to search and select their desired organization from the list of existing organizations in your system. For example: in the research space, you may want to allow researchers to independently register for, and apply to, grants under an existing research body such as a university.

Typically, you will not want a list of all organizations you deal with exposed to the public, so on the configuration page you can filter the list of available organizations by organization category and status. This way new users will only be able to search and create themselves under a subset of organizations in your system.

You may also want to consider adding a vetting process utilizing workflows and the users’ status before giving users who self-register under an existing organization full access to the system.

From the user perspective a new user goes to the desired signup page and then starts typing the name of their organization and they will see a list of organizations meeting that criteria. Once the user selects the desired organization, they enter their user information, and upon submission, the user is created under the chosen organization. Note the user would still need to activate themselves as usual.

How to Set up an Organization Lookup Signup Page

  1. Setup a user signup page as per above.
  2. Setup an organization signup page as per above.
  3. On the organization signup page, select the user signup page as per above.
  4. For the Selected Fields on the organization signup page, you only need the Name field.
  5. For the Verification Service dropdown under the "Verification Settings" section, select "Internal Organization Lookup".
  6. Choose the desired Lookup Category and Lookup Status of organization you want users to be able to see and select. For example: you may only want organizations in the category of "Non-profit" and status of "Active" to appear in the list of organizations the user can attach themselves to.
  7. Scroll up to the "Signup Page Content" section and modify the Instructions Content field as desired. You may want to add something like "Start typing the name of your organization and select it from the list. Fields marked with a red asterisk (*) are required. If you need assistance contact fake@fake.fake."
  8. Click Save.

Using External Verification Services on Your Signup Page

You can create a signup page that will confirm an organization’s charity status by selecting an organization based on a third-party database prior to registering that organization in your system.

The information from the selected database such as Name, City and State is used to populate the organization signup page fields.

If the desired organization cannot be found in the third-party database (Example: It was added after the most recent update), you can provide a link to another signup page where that organization could still register.


Step one: User searches for their organization in the IRS database.
Step two: User selects their organization from the list and the information is automatically populated into the registration form.

The following services are available

Verification Service Description Link to Data Update Frequency
ABN The Australian Business Number (ABN) lookup contains a list of businesses that have registered with the Australian Business Register. ABN Lookup Real Time
CRA The Canada Revenue Agency (CRA) lookup contains a list of T3010 Registered Charities. CRA Data Monthly
CC The Charity Commission for England and Wales (CC) lookup contains a list of registered charities.  CC Data Monthly
CH United Kingdom Companies House (CH) contains a list of registered UK companies.  CH Data Monthly
CRO The Companies Registration Office Ireland (CRO) is the central repository of public statutory information on Irish companies and business names.  CRO Data Real Time
IRS The Internal Revenue Service (IRS) lookup contains a list of 501(c)(3) and other charitable organizations.  IRS Data Monthly
NCES The National Center for Education Statistics (NCES) lookup contains data for all public elementary and secondary schools in the US.  NCES Data Annually

How to Set up a Signup Page That Uses an External Verification Service

Generally, you set up each verification service in a similar way. Below is how you setup a signup page using the IRS verification option. Before you begin, you need to setup a custom field to hold the Employer Identification Number (EIN) value. The EIN is a Federal Tax Identification Number, it is a unique nine-digit number assigned by the Internal Revenue Service (IRS) to business entities operating in the United States. Other verification services will have a different identification number.

  1. If you do not already have a custom field to hold the EIN number, create a Text Box - Text Single Line custom field in the organization custom fields, and permission this field to be available as desired.
  2. Setup a user signup page the same way as above.
  3. Setup an organization signup page the same way as above.
  4. On the organization signup page select the desired user signup page as per above.
  5. In the Input Form section drag and drop the EIN custom field you created from the Available Fields to the Selected Fields. You must add a custom field for this number in order to use the IRS verification feature.
  6. For Verification Service select United States Internal Revenue Agency (IRS).
  7. Click Sample Instructions for both Search Instructions and Result Instructions.
  8. For Additional Automatic Field Population click the Add Mapping Field button that looks like a plus sign to create a new row.
  9. From the Mapping Field column drop down, select Registration Number (EIN).
  10. In the Custom Field input column right beside the mapping field, start typing the name of the EIN field you created and select it from the list.
  11. Click Save.

How to Attach Workflows

You can attach an existing workflow to a signup page using the Attach Workflow setting. You can create Workflows under the Menu Icon > Workflows. Workflows on signup pages are typically used to to notify someone that a new user has registered and or some action needs to be taken such as an approval and/or to automatically run some tasks upon signup.

How to Set up an Eligibility Questionnaire

If there are criteria that would render an applicant ineligible to gain access to your system, you may want to setup an eligibility questionnaire that a user must fill in before you let the user register. This is typically done with a Universal Tacking Application (UTA). In the UTA, ask any questions that would cause an applicant to be ineligible. For example, if you don't fund religious organizations or organizations in a specific area, ask applicants these question before you allow them to register. If the applicant meets your desired criteria, then give them a link to the desired signup page. If applicant fails your criteria, then let them know they are ineligible. Using this method saves the user time by letting them know up front if they are not going to be given access and it saves you time by reducing the number of users created in your system.

Other Vetting Processes

Some organizations require users and organizations to be manually vetted or approved before the user gains access. This is typically done by using the User/Organization status in conjunction with workflows to notify the appropriate internal staff.

Some organizations also require regular OFAC checks to be conducted on the organizations they fund, to ensure they are not in violation of economic and trade sanctions based on U.S. foreign policy, and national security goals against targeted foreign countries and regimes, terrorists, international narcotics traffickers, those engaged in activities related to the proliferation of Weapons of Mass Destruction, and other threats to the national security, foreign policy or the economy of the United States.

OFAC publishes a list of individuals and companies owned or controlled by, or acting for or on behalf of, targeted countries. It also lists individuals, groups and entities, includes terrorists and narcotics traffickers designated under programs that are not country-specific. Collectively, such individuals and companies are called Specially Designated Nationals or SDNs. Their assets are blocked, and U.S. persons are generally prohibited from dealing with them.

You can learn more about OFAC here https://www.treasury.gov/about/organizational-structure/offices/Pages/Office-of-Foreign-Assets-Control.aspx

How to Delete/Purge Your Information

When users sign up to gain access to your system, they provide you with Personal Identifiable Information (PII). We suggest you provide your users with information of who they should contact in regards to purging or deleting any personal information held within your system.

When you set up user Standard and Custom fields, there is also a toggle you can enable called Classify as Personal Data to alert people of the PII collected in fields. You can you also specify why you are collecting this PII.

Some organizations will set up data retention policies to remove PII after a set period of time, whereas other organizations may remove PII upon request. Either way, you should provide some way to contact someone acting as a privacy officer within your organization in regards to any privacy concerns from your users.

CAPTCHA

CAPTCHA (which stands for "Completely Automated Public Turing Test to tell Computers and Humans Apart") is used to minimize the occurrence of spam records being submitted via bots. CAPTCHA will reduce the amount of spam you receive, but it will not block all spam from bots.

CAPTCHA settings can be found at Menu icon > Global Settings > Security tab.


CAPTCHA Alternatives

By default, systems use Google reCAPTCHA. For users in countries that are unable to communicate with Google servers due to government policy, you may wish to enable the alternate CAPTCHA.

Alternate CAPTCH can be used by typing the country name into the input called Countries Using Alternate CAPTCHA Service.

Set Countries Using Alternate CAPTCHA Service to a list of relevant countries .

How to Test Signup Pages

Signup pages must be activated before they can be previewed and tested. To test a page, do the following:

  1. Go to the signup page settings and scroll to the "Activation and Security" section.
  2. Ensure the Activate Page Toggle is enabled and click Save.
  3. Under the "Activation and Security" section, copy the URL populating the Standard field.
  4. In the Google Chrome browser paste the URL into the address bar of a new incognito mode tab and press enter. This will display a preview of your signup page.
  5. To test the page, simply complete the appropriate details and submit the form. If successful, a confirmation message will be displayed.
  6. The submitted user/organization will be listed under the associated organization in the Organization Hierarchy chart. Go to Menu Icon > Organization Hierarchy > External tab to view the newly created organization and or user.

Tip: Keep Signup Pages Short

- Don’t ask every question you think you need upfront on the signup page. Once a user has registered and logged into the system, you can ask them more questions as part of your process.

- The shorter your signup page, the greater your completion rate will be, so ask the minimum amount of questions possible. Go through each question and ask yourself: why are we collecting this information, and how are we using it?

- Have someone else fill in your form and look critically at how they answered. Did they answers the way you expected? Do you need to revise the question or provide instructions to ensure you get desired responses?

- If a question is not marked mandatory, do you still need to ask it? and if so when do you need to ask it?

Settings Explained

General Tab

The following settings are available on the General tab:

General Settings

Setting Description
Signup Page Name Use to differentiate signup pages.
Associated Organization Determines where the users and organizations created will reside in your organization hierarchy. Typically, you would create an organization in the external organization hierarchy and call it something like “Web Registrants”. Note container organizations should be flagged as such.
Description This input is not seen by your applicants but is used to differentiate signup pages when you are picking a user signup page from the organization signup configuration page. You may also wish to add special instructions or notes for other administrators in this field.

Activation & Security

Setting Description
Activate Page The signup page will only be accessible if this setting is toggled on. If this setting is toggled off and a user navigates to this signup page they will receive an error message asking the user to contact your system administrator.
Enable Field Security Token This setting enhances security of signup pages by validating the fields that are submitted with expected values. Typically, this should be toggled on.
Standard Provides a link to this signup page which you can give to people who want to register in your system. Click the View button to see the signup page, or click the Copy button to copy the URL to this signup page.
Email Broadcast This is an alternate URL intended for updating existing users in conjunction with the email broadcast tool. This link is typically, not used.

Signup Options

Setting Description
Duplicate Check Field Select one or more fields to be used by the duplicate check. Typically, Email is used for users and Name is used for organizations. If you choose to check on more than one field the operation used is AND. For example: if you chose email and first name, it will only flag users that have the same email and first name. If you want to use OR you must click the Add Duplicate Check Condition button.
Form Submission Behavior On the User Signup page. Most people use the default Create new user only if no existing match found. On the organization signup page. Most people use the default Create new organization only if no existing match found
Duplicate Restriction Message Enter a custom message you want displayed when the duplication check fails. By default, it will say “A user/organization matching the information you entered already exists. Please contact your system administrator.”
Access Type Only available on the User signup page. Set to User Access if you want the user to be able to login. This setting only applies to new users. New users will be given the access type selected. The Access Type for existing users will not change.
User Signup Only available on the organization signup page. Choose between Single User which will create one user along with the organization or Multiple Users which can create multiple sets of users along with the organization.
User/Multiple User Signup Page Only available on the organization signup page. Select the user signup page(s) you want to attach to the Organization signup page. The User signup page, will show up inside the organization signup page in its own section that appears under the organization details section.
SmartCheck Validation Select the SmartCheck validation you want to run upon form submission. Note if you are on an Organization Signup Page with a User Signup Page attached, the SmartCheck validation from the User Signup Page will be automatically included.
Attach Workflow Select the desired workflow you would like to run upon the registration of a new user or organization. Typically, workflows on signup pages notify someone that a new user has registered and or some action needs to be taken or the workflow will run some task automatically.
Attach Policies Only found on the User Signup page. Select the policy you want users to be forced to accept before they can register. Typically, you would select a privacy policy that details your company’s views and procedures related to the collection of information on people who use your system. This way a new user can see and accept your policies before they enter any personally identifiable information (PII) into your system. Alternatively you may wish to attach a policy to the login page instead which will be enforced upon the users first login. Note polices attached prior to login cannot include any role our country based permissions.
Default Country This setting is used to specify a default country on the signup page. For example, if all applicants registering via this signup page live in the United States, you might choose that option as the default country to save users some time.

When the form opens, if the value chosen is United States then that value will automatically be pre-selected in the Country field for the user. The user can still change the Country field value if they wish.

Default State This setting is used to specify a default state or province on the signup page. For example, if all applicants registering via this signup page live in New York, you might choose that option as the default state to save users some time.

When the form opens, if the value chosen is New York then that value will automatically be pre-selected in the state field for the user. The user can still change the state province field value if they wish.

Default Status Select the status you want to give the User/Organization upon registering. Statuses are like a place in time; for example, you might use a "Newly Registered" status for new registrants, and later once they have been vetted, you might switch them to an "Active" Status.
Categories Only found on Organization signup pages. Categories are a way of grouping like organizations together and are used to control what can be seen and done. You can Add, Remove or Update categories for Organizations using this setting.
Roles Only found on User signup pages. Roles are a way of grouping like users together. We use roles to control what the user can see and do in the system. You can Add, Remove or Update roles for Users using this setting.
Page Layout This setting controls the layout of the page. Default is recommended as you will always get the latest and greatest signup page template. If you select Custom you will be able to add the sample template and customize the HTML of the signup page. However, if you select custom, your template will not get updated with future upgrades and as such you may be need to manually update your custom template to ensure it continues to work as expected after each upgrade.

Signup Page Content

Note that this section only appears on Organization signup pages.

Setting Description
Page Title If you want to add some text such as “registration” into the header beside your logo you can add it here. Typically, this input is left blank.
Company/Contact Section Title This text will appear above the fields where you enter organization/contact data. Typically, people enter “Organization Information” on the organization signup page and “User Information” on the user signup page.
Instructions Title Text entered here will appear inside the instruction box above your instructions. Typically, people enter “Registration”.
Instructions Content Add any custom instructions to help user complete the signup page. Typically, people enter “Fields marked with a red asterisk (*) are required. If you need assistance contact Fake@fake.fake.”.
Enable Same Address button Only found on the Organization signup page with a user signup page attached. Toggle on to get a button that will populate the user address fields with the values entered into the Organization address fields. This feature will save users time if their organizations and user addresses are the same.
Same Address Button label Define the caption you would like to see on the same address button. The default is “Copy Address”.
Submit Button Label Define the caption you would like to see on the form submission button. 
Display Login Link on Page This setting is used when a user is invited to contribute to an application via a personal email but they already have an existing account under another email they would like to use.
Enable Email Confirmation Only found on the user signup page and typically left disabled. This setting displays an email confirmation field when the email standard field is included on the form.

Confirmation Page Content

These settings can only be found on user signup pages.

Setting Description
Confirmation Page Title Large text displayed after the user has submits the form. Typically, people enter “Registration Complete”.
Confirmation Page Content Smaller text displayed after the user submits the form. Appears under the title. Typically, people enter “Thank you for registering. Activation instructions have been emailed to you”.
Link Text Text used for a link to the login page so people can log in after registering. Typically, people enter either “Log in here” or “Visit youralias.smartsimple.com”.
Link URL Link to login page. Typically, people enter “/s_Login.jsp”.

Input Form

Setting Description
Available Fields The list of fields you can pick from. Drag and drop these fields into the Selected Fields area.
Selected Fields Any fields in this area will be displayed on the signup page. Reorder fields within this area using drag and drop. To remove fields, hover over the desired field and click the “x” button.


Verification Settings

These settings can only be found on Organization signup pages.

Setting Description
Verification Service Select the type of internal or external verification service you would like to use. Example internally you might want to search your systems organization hierarchy for a specific organization and add a new user under that organization. Externally you might want to search Internal Revenue Service data to ensure new charitable organizations that register have 501(c)(3) status and then populate that organizations information from the IRS database.
Lookup Category Only available if Internal “Organization Lookup” is selected. Select the Categories of organizations you want to appear when a user searches for an organization to add themselves to. Typically, only charitable or research organization categories would be chosen.
Lookup Status Only available if Internal “Organization Lookup” is selected. Select the Status of organizations you want to appear when a user searches for an organization to add themselves to. Typically, only organizations in an approved, or active status would be chosen.
Limit Searchable Fields to ID Only if you toggle this setting on, users will only be able to search on the ID of the organization, not the name, state or other fields. For example, if you were doing an IRS search you will only be able to search the EIN number.
Limit Results to US Based Organization Only Only available for IRS. Toggle this setting on if you only want US based organizations to show up in the list of search results.
Search Instructions (HTML) Click the sample Instructions, and modify the provided text as desired. Typically, this explains how the user can search.
Result Instructions (HTML) Click the sample Instructions, and modify the provided text as desired. This text will show up on the results page after you have searched for an organization. Typically, this explains how to select your desired organization.
Disable Automatic Field Population When you select an organization from the verification service, the inputs on your form will be automatically populated. If your signup page does not include inputs for city, state or zip/postal code, check the ones that are not present on your signup page. This will prevent an error when the verification service tries to populate fields that don’t exist on your form.
Additional Automatic Field Population Only available with IRS verification service. Click the add mapping field button under the mapping field column to add a mapping field. Then select a mapping field from the drop down. Then in the custom field column start typing the caption of the desired custom field, then click it to select that field. Note that the custom field you select must also be in the selected fields list in the Input Form section.
Exclude Foundation(s) Only available with IRS verification service. Select foundations types you want to exclude from the search.
Exclude Subsection(s) Only available with IRS verification service. Select subsections you want to exclude from the search.

Templates

The following settings are available on the templates tab if Page Layout is set to Custom.

The page template allows you to modify the HTML of the signup and confirmation page and is generally not recommended. If you choose to customize the HTML of your signup page you won’t get the latest and greatest templates and you may be required to update your HTML if changes to templates or functionality occur in an upgrade.

Signup Page Template

Click the Sample Template link to add the html of the signup page into the input and then modify as desired.

Confirmation Page Template

Only available on user signup pages. Click the Sample Template link to add the html of the signup page into the input and then modify as desired.