Surfer

Article Topics: Customization, Members

The Configuration Admin's "Surfer" section allows you to customize the way specific surfer actions function as well as what is being recorded.

Set a cookie hostname, when it expires, and how long to keep cookies.

Important: Before making any changes, we recommend you review the Cookie Settings page.

Cookie Hostname - The default hostname used for cookies.
NATS Cookie Expire - Set the Length of time (in seconds) to keep surfer cookies for tracking referring NATS codes.
Cookie Domain - Set the Domain that NATS will set cookies on.
HTTP Cookie Secure - Determine whether to set a Secure flag for cookies so they are only sent over HTTPS connections.
HTTP Cookie Secure Surfer - Determine whether to set a Secure flag for cookies (for surfers) so they are only sent over HTTPS connections.
HTTP Cookie Secure Member - Determine whether to set a Secure flag for cookies (for members) so they are only sent over HTTPS connections.
HTTP Session Secure - Determine whether to set a Secure flag for session cookies so they are only sent over https connections.
HTTP Session Secure Surfer - Determine whether to set a Secure flag for session cookies (for surfers) so they are only sent over HTTPS connections.
HTTP Session Secure Member - Determine whether to set a Secure flag for session cookies (for members) so they are only sent over HTTPS connections.
HTTP Cookie Samesite - Set the samesite flag to set for cookies, which affects cross-domain requests and redirects.
HTTP Cookie Samesite Surfer - Set the samesite flag to set for cookies (for surfers), which affects cross-domain requests and redirects.
HTTP Cookie Samesite Member - Set the samesite flag to set for cookies (for members), which affects cross-domain requests and redirects.
HTTP Session Samesite - Set the samesite flag to set for session cookies, which affects cross-domain requests and redirects.
HTTP Session Samesite Surfer - Set the samesite flag to set for session cookies (for surfers), which affects cross-domain requests and redirects.
HTTP Session Samesite Member - Set the samesite flag to set for session cookies (for members), which affects cross-domain requests and redirects.
Surfer Unique Time - Length of time (in seconds) to keep cookies for unique surfers.
Enable NATS Affiliate Site Cookie Expire - Enable the use of affiliate and site-specific cookie expire times.
Signup Shortpath - Enable short-style signup links. If disabled, short-style signup links will redirect to the signup page.

Tracking

Choose a method of tracking visitor countries; each country's tracking method requires supporting software to make it work.

IP Filter - The method used for tracking the country of the surfer.
GeoIP2 PHP Database Location - Set the location of the Geo IP 2 Database.
Disable Auto Campaigns - Set whether to allow affiliates to create campaigns on the fly.
Disable Gallery Hit Tracking - Set whether to disable tracking of the adtool hits.
Default Click URL - Set the default link when a bad tracking code is used.
Meet P3P Compliance Track - Set whether to send P3P header for track.
Meet P3P Compliance Signup - Set whether to send P3P iframe compliance header for signup.
Meet P3P Compliance Include - Set whether to send P3P iframe compliance header for include.
Remove Extra Query Tracking Vars - Remove additional tracking link codes variables from the query string on the redirect (nats_at array).
iPad As Mobile - Detect iPad traffic as mobile, for the purposes of mobile tours and join templates.
Redirect On Bad Strack Parameters - Redirect strack traffic to this URL in the event of invalid parameters.
Redirect Linkdomain On License - Redirect linkdomain to the tour/join page instead of the license page.
Redirect License URL - Redirect linkdomain on the license page to this URL. (If config Redirect Linkdomain On License is turned on, this setting will get overridden when linkdomain is found.
Permanent Redirect Track - Do a 301 (permanent) instead of a 302 (temporary) redirect on track links.
Permanent Redirect Adtool - Do a 301 (permanent) instead of a 302 (temporary) redirect on ad tool links.
Permanent Redirect Promo - Do a 301 (permanent) instead of a 302 (temporary) redirect on promotional links.
Permanent Redirect Switch - Do a 301 (permanent) instead of a 302 (temporary) redirect on strack links.

Please Note: These settings are only applicable if you are using the Member Logging Feature.

Member Mismatch IP Flag - Set whether to flag members when they log in from multiple IPs.
Member Mismatch IP Notification - Set whether to send an admin notification when individual members log in from multiple IPs.
Member Mismatch IP Email - Set one or more email addresses that will receive information when individual members log in from multiple IPs. Separate multiple email addresses with a comma.
Member Loginlog Check Skip Joinip - Set whether to skip the member log.
Member Mismatch IP Logins - Set the distinct IP count to trigger an action (flag/notification/email) when a member logs in from multiple IPs.
Member Mismatch IP Time Range - Set the time period (in seconds) to search the login history for distinct login IPs. 0 being all time.

This section allows you to set options for use on the NATS signup form, including member-related, gateway-related, and cascade-related settings.

Before detailing the list of Signup Form configuration settings, two important settings need to be highlighted. These are the Member Get New Username and Unique Member Names settings.

Member Get New Username

NATS can recommend new usernames to visitors if the name they select is already in use. Display these recommendations by adding the following code to your join template.

{if $vars.recommended}
    The username you entered was taken, please try one of these.<br />
    {foreach from=$vars.recommended item="usernameR"}
        {$usernameR}
    {/foreach}
{/if}

By default, NATS generates four usernames. To disable these recommendations, set the Member Get New Username configuration variable to 0 in your NATS configuration file, nats/config.php.

If you change MEMBER_GET_NEW_USERNAME to any other number between one and 25, NATS generates that number of username recommendations.

Unique Member Names

This configuration setting determines whether or not members on separate sites can have the same username (members on the same site can never have the same username).

There are 9 options:

0 Only unique within site -- this is the default setting in NATS.
1 Unique across all sites -- NATS checks all sites for this username, instead of just the current site.
2 Xsells -- Only Xsell members must be unique across all sites. Members joining through the nats join form need only be unique within their site
3 Join Form -- Only members using the NATS join form must be unique across all sites. Members joining through an xsell need only be unique within their site
4 Join Form (allow matching emails), Xsells -- A member using the join form can join a second site if both the usernames and emails match. If just the username matches, it is not allowed. Members joining as an xsell MUST have a unique username.
5 Xsells (allow matching emails), Join Form -- A member joining as an xsell can join a second site if both the usernames and emails match. If just the username matches, it is not allowed. Members joining on the join form MUST have a unique username.
6 Join Form (allow matching emails) -- A member using the join form can join a second site if both the usernames and emails match. If just the username matches, it is not allowed. Members joining as an xsell need only be unique within their site.
7 Xsells (allow matching emails) -- A member joining as an xsell can join a second site if both the usernames and emails match. If just the username matches, it is not allowed. Members joining on the join form need only be unique within their site
8 Join form and Xsells (both allow matching emails) -- A member using the join form can join a second site if both the usernames and emails match. A member joining as an xsell can join a second site if both the usernames and emails match. If just the username matches, it is not allowed.

Skip Countries - Comma-delimited list of two-letter codes for countries you do NOT want on your join form. Leave empty to show all.
Affiliate Skip Countries - Comma-delimited list of two-letter codes for countries you do NOT want on your signup form. Leave empty to show all.
Random Userpass Disallow List - Characters not allowed for random user/pass generation.
Member Get New Username - Number of new username attempts when inserting a member with an unavailable username. (0 to disable)
Member Postback Url Delayed - Select a time delay for all Postback URLs set in Sites Admin.
Unique Member Names - Determines the degree of uniqueness required for member usernames.
Never Rename Expired Members - Prevents NATS from renaming any expired members. Unless Reuse Matching Username is on, this prevents members from signing back up.
Expired Member Rename Delay - Allow renaming of expired members only if they have been expired for the configured amount of seconds.
User Pass Matchok - Allow the username and password to match.
Reuse Matching Username - Allow adding a new subscription to an existing member on username and e-mail match.
Reuse Active Users With Matching Password - Requires passwords to match when Re-Use Active Usernames is turned on.
No Random Passwords - Do not create a random password for signup without a password.
Members No Unencrypted - Only store hashed (one-way encrypted) passwords for member records.
Members No Active Unencrypted - Only store hashed (one-way encrypted) passwords for active member records.
Members No Empty Password - Force a random member password if empty on signup submit.
Members No Empty Password Length - Length of forced random password. Default is 10.
Members No Empty Password Prefix - Prefix for forced random member password.
Disable Redirect On Bad Code - Disable redirect link on bad linkcodes.
Gateway True Cascade - Enable True Cascading between gateways.
Gateway Year Forward Years - Default years ahead for gateway dropdown.
Cascade Security Max Member Age - Maximum age (idle time) of members to allow cascading.
Cascade Security No Status - Allow cascading of members that already joined.
Cascade Security No Session - Allow cascading of members that have mismatched session IDs.
Gateway HTTPS- Prefix this in front of the redirects to gateway join forms. This is for using https URLs for gateway join pages only but not for the other join pages. Do not use this unless you know what you are doing.
Min Age - Minimum age used for age checks on the join form.
Disallow Chargeback Member Signup - Deny members with a previous chargeback using the same e-mail address. No
Fail On Insufficient Tokens - Return failed if attempting to update a member's tokens to less than 0.
Enable Ncr Email Verification - Turn on the ability to require email verification for No Cost Registration options.
Ncr Activation Code Expire - Number of seconds No Cost Registration activation codes stay valid for.
Join Email Blacklist - Comma-separated list of emails that should be rejected when used on the join form.
Member Signup Captcha Style - Style of captcha to use on the join forms.
Member Signup Use Captcha - If Set, all member signups will require a CAPTCHA verification.
Member Retry Captcha - Number of tries a surfer can make to sign up before a CAPTCHA is used.
Member Retry Captcha Hours - Number of hours to look back when checking against the MEMBER_RETRY_CAPTCHA configuration. By default, NATS will look for signup attempts within the past hour.
Member Signup Google Recaptcha Key - Key that will get used in the HTML code on your join forms (required when using Google reCAPTCHA style).
Member Signup Google Recaptcha Secret - Secret used for communication between your join forms and Google (required when Google reCAPTCHA style).
Password Display On Approval Seconds - The maximum amount of time the password value is allowed to be displayed on the approval page after cascading.
Luhn Check Gateway Fields - Force the Luhn check on all fields submitted on the gateway join page (other than the credit card field) to make sure the surfer did not accidentally put in the credit card number in the wrong field.
Luhn Check Credit Card - Force the Luhn check on the credit card field.
Program Switch Priority - Determines the priority of program switches when multiple are detected.
Returning Customer Checks - All checks are run by default. To override, comma separate the list of checks you want to run.
- Possible checks:
  - username_email
  - email_only
  - session_only
  - username_password
  - ip_username
  - ip_password
  - name_zip

One Click Systems

This section allows you to customize how various One Click Systems function in NATS.

Cancelplus Enabled - Determines whether or not the plus system is enabled.
Chargeplus Enabled - Determines whether or not the plus system is enabled.
Packageplus Enable - Determines whether or not the plus system is enabled.
Packageplus Required Fields - Determines what fields are required for Package Plus verification.
Packageplus Inherit Subscription Passthrough Data - Determines if subscription pass-through values from the previous subscription are used when making the new subscription record during the Package Plus process.
Tokenplus Enabled - Determines whether or not the plus system is enabled.
Tokenplus Required Fields - Set the option to determine what fields are required for Token Plus Verification.
Tokenplus Inherit Subscription Passthrough Data - Set the option to determine if subscription pass-through values from the previous subscription are used when making the new subscription record during the Token Plus Process.
Tokenplus Skip Hidden Join Options - Set whether to display hidden join options on the tokenplus.php page unless they are passed in. This option does not prevent processing, only the displaying of the join options.
Signupplus Enabled - Determines whether or not the plus system is enabled.
Signupplus Required Fields - Determines what fields are required for Signup Plus verification.
Signupplus Inherit Subscription Passthrough Data - Determines if the current subscription pass-through values are re-used when updating the subscription during the Signup Plus process.
Upgradeplus Enabled - Determines whether or not the plus system is enabled.
Upgradeplus Inherit Subscription Passthrough Data - Determines if the current subscription pass-through values are re-used when updating the subscription during the Upgrade Plus process.
Upsellplus Enabled - Determines whether or not the plus system is enabled.
Allow Member IP Post Upsell - Allow member IP address to be passed into Upsell Plus (enabling this may cause NATS throttling to be ineffective).
Retry Upsell Member Lookup - Number of times NATS will retry on lookup member record during the approve redirect for upsell.
Retry Upsell Member Sleep - Number of times NATS will wait before the next member lookup during the approve redirect for upsell.
Upsellplus Skip Hidden Join Options - Do not display hidden join options on the upsellplus.php page unless they are passed in. This option does not prevent processing, only display.
Verifyplus Enabled - Determines whether or not the plus system is enabled.
Additional Sign Key - The key that is used to sign the additional array in the calls to the *plus scripts (must be at least 16 characters long).

ATVOD Verification

ATVOD Verification - Turn on/off ATVOD verification for signups.
ATVOD Verification All Sites - Require ATVOD verification for all sites.
ATVOD Client ID - Client ID value for the ATVOD verification calls.
ATVOD Operator ID - Operator ID value for the ATVOD verification calls.
ATVOD Password - Password value for the ATVOD verification calls.
ATVOD Authenticate Profile ID - AuthenticateProfileID value for the ATVOD verification calls.
ATVOD Passport Profile Id - PassportProfileID value for the ATVOD verification calls.
ATVOD Driving License Profile ID - DrivingLicenceProfileID value for the ATVOD verification calls.
ATVOD Geoip Country Matches - Comma-delimited list of GEOIP results that will be required to go through ATVOD verification.
ATVOD Name Country Matches - Comma-delimited list of MEMBER ADDRESS values that will be required to go through ATVOD verification.

Age Verification

The following settings allow you to configure Age Verification.

Age Verification - Turn on or off Age Verification for Member Signups.
Age Verification Retry Count - The number of retires allowed for Age Verification before the member is denied.
List Countries Age Verify - A comma delimited list of states to be enabled for age verification. This requires GEOIP2_PHP with GEOIP2_CITY_DB_PATH setup. Please do not enable this unless GeoIP is working for countries.
List State Age Verify - A comma delimited list of states to be enabled for age verification. This requires GEOIP2_PHP with GEOIP2_CITY_DB_PATH setup. Please do not enable this unless GeoIP is working for states.
Age Verification Days - Set how many days before having to verify members again.
Test Age Verification IPs - A comma delimited list of IPs to only allow test mode for age verification. This setting will disable age verification for all other IPs and only test IPs will work with age verification.
Verify Unlocated Users - If a user's country or state can not be determined, treat it as a match to a country/state list.
Age Verification US State Only - If enabled, it will check the List State Age Verify config will only verify US states.

Member Notes

The following settings allow you to set Member Note whenever a certain action is performed.

Member Notes On Cancelplus - Set whether to store Cancel Plus results in member notes.
Member Notes On Instant Upgrade Nsf - Set whether to add a member note on an instant upgrade NSF.
Member Notes On Membership Extension - Set whether to add a member note on a biller membership extension.
Member Notes On Failed Conversion Upgrade - Set whether to add a member note on a trial to a full upgrade on a failed conversion.
Process Shop Passthrough Order - Set the option to determine which set of pass-throughs will be prioritized when processing shopping cart sales.
Process Extended Passthrough Order - Set the option to determine which set of pass-throughs will be prioritized when processing extended sales.

Member OpenID Connect Server

Please Note: Be sure to read the OpenID Connect page before adjusting these settings.

Enable Member OpenID - Set whether to enable OpenID Connect server for member logins.
Member OpenID Secure IPS - Comma-delimited list of client (member area) IPs.
Member OpenID Client Secret - OpenID Connect client secret (password).
Member OpenID Domain - Domain (with protocol) to use for the OpenID Connect server for members.
Member OpenID Dynamic Domain - Allow dynamic domain for the OpenID Connect server.
Member OpenID Signing Key Id - The name (kid) of the key used for signing JSON Web Tokens.
Member OpenID Base Info - Provide basic member info to the client (member area) on successful authentication.
Member OpenID Join Expire Info - Provide join and expire dates to the client (member area) on successful authentication.
Member OpenID Identifier Info - Provide identifier info to the client (member area) on successful authentication.
Member OpenID Address Info - Provide address info to the client (member area) on successful authentication.
Member OpenID Custom Info - Provide custom variables to the client (member area) on successful authentication.
Member OpenID Passthrough Info - Provide subscription passthrough variables to the client (member area) on successful authentication.
Member OpenID Expired Login - Allow expired members to login.
Member OpenID Descriptive Login Error - Provide a descriptive error for members when failing to login.
Member OpenID Setup Error Show Template - Show the login_error template in NATS instead of redirecting back to the members area on bad setup.
Member OpenID Auth Code Duration - Auth code duration (in seconds).
Member OpenID Access Token Duration - Access token duration (in seconds).
Member OpenID Sign Userinfo Reply - Sign the userinfo endpoint reply.
Member OpenID Redirect Error Detail - Include error details in error redirects from the authorization endpoint.
Member OpenID Post Error Detail - Include error details in error responses to the token and the userinfo endpoints.

Restricted Value List

Here's the information you provided presented as a single column:

Restricted Value List Match Notification - Send an admin notification when there is a restricted value list match.
Restricted Value List Match Email - Send an email to the following address when there is a restricted value list match. Separate multiple email addresses with a comma (,).
Restricted Value List Match Username Ncr - Perform a restricted value list search on the member username field for NCR transactions.
Restricted Value List Match Firstname Ncr - Perform a restricted value list search on the member firstname field for NCR transactions.
Restricted Value List Match Lastname Ncr - Perform a restricted value list search on the member lastname field for NCR transactions.
Restricted Value List Match Username Third Party - Perform a restricted value list search on the member username field for third-party transactions.
Restricted Value List Match Firstname Third Party - Perform a restricted value list search on the member firstname field for third-party transactions.
Restricted Value List Match Lastname Third Party - Perform a restricted value list search on the member last name field for third-party transactions.
Restricted Value List Match Username Initial - Perform a restricted value list search on the member username field for initial transactions.
Restricted Value List Match Firstname Initial - Perform a restricted value list search on the member firstname field for initial transactions.
Restricted Value List Match Lastname Initial - Perform a restricted value list search on the member lastname field for initial transactions.
Restricted Value List Match Username Rebill - Perform a restricted value list search on the member username field for rebill transactions.
Restricted Value List Match Firstname Rebill - Perform a restricted value list search on the member firstname field for rebill transactions.
Restricted Value List Match Lastname Rebill - Perform a restricted value list search on the member lastname field for rebill transactions.
Restricted Value List Match Username Change Details - Perform a restricted value list search on the member username field for change details events.
Restricted Value List Match Firstname Change Details - Perform a restricted value list search on the member firstname field for change details events.
Restricted Value List Match Lastname Change Details - Perform a restricted value list search on the member lastname field for change details events.
Restricted Value List Match Username Manual - Perform a restricted value list search on the member username field for manual transactions.
Restricted Value List Match Firstname Manual - Perform a restricted value list search on the member firstname field for manual transactions.
Restricted Value List Match Lastname Manual - Perform a restricted value list search on the member lastname field for manual transactions.

PreviousSecurity NextThird Party

Last updated 2 months ago

Was this helpful?

Cookie Settings

Tracking

Member Login Log

Signup Form

Member Get New Username

Unique Member Names

Remaining Signup Form Settings

One Click Systems

ATVOD Verification

Age Verification

Member Notes

Member OpenID Connect Server

Restricted Value List