commiting uncommited changes on live site
[weblabels.fsf.org.git] / crm.fsf.org / 20131203 / files / sites / all / modules-new / civicrm / templates / CRM / UF / Form / Group.hlp
1 {*
2 +--------------------------------------------------------------------+
3 | CiviCRM version 4.6 |
4 +--------------------------------------------------------------------+
5 | Copyright CiviCRM LLC (c) 2004-2015 |
6 +--------------------------------------------------------------------+
7 | This file is a part of CiviCRM. |
8 | |
9 | CiviCRM is free software; you can copy, modify, and distribute it |
10 | under the terms of the GNU Affero General Public License |
11 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
12 | |
13 | CiviCRM is distributed in the hope that it will be useful, but |
14 | WITHOUT ANY WARRANTY; without even the implied warranty of |
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
16 | See the GNU Affero General Public License for more details. |
17 | |
18 | You should have received a copy of the GNU Affero General Public |
19 | License and the CiviCRM Licensing Exception along |
20 | with this program; if not, contact CiviCRM LLC |
21 | at info[AT]civicrm[DOT]org. If you have questions about the |
22 | GNU Affero General Public License or the licensing of CiviCRM, |
23 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
24 +--------------------------------------------------------------------+
25 *}
26 {htxt id='id-description-title'}
27 {ts}Help Description{/ts}
28 {/htxt}
29 {htxt id='id-description'}
30 {ts}Explanatory text for profile.{/ts}
31 {/htxt}
32
33 {htxt id='id-used_for-title'}
34 {ts}Used For{/ts}
35 {/htxt}
36 {htxt id='id-used_for'}
37 {ts}Profiles can be used in many different ways (and a single profile can be used in multiple contexts){/ts}:<br />
38 <ul class="left-alignment">
39 <li>{ts}You can collect additional information about a donor or event participant by including profiles directly in Online Contribution Pages and Event Registration forms. When using a profile in this manner you do not need to check any of the "Used For" checkboxes.{/ts}</li>
40 <li>{ts}Check <strong>Standalone Form or Directory</strong> if you want it to use this profile for custom forms, or contact listing and view screens (from the civicrm/profile path).{/ts}</li>
41 <li>{ts}Check <strong>Search Results</strong> to use this profile to display an alternate set of results columns for CiviCRM Basic and Advanced Search.{/ts}</li>
42 {if $config->userSystem->supports_form_extensions EQ '1'}
43 <li>{ts}Check <strong>User Registration</strong> if you want this Profile to be included in the New Account registration form.{/ts}</li>
44 <li>{ts}Check <strong>View/Edit User Account</strong> to include it in the view and edit screens for existing user accounts.{/ts}</li>
45 {/if}
46 </ul>
47 {docURL page="user/organising-your-data/profiles/"}
48 {/htxt}
49
50 {htxt id='id-profile_weight-title'}
51 {ts}Weight{/ts}
52 {/htxt}
53 {htxt id='id-profile_weight'}
54 {ts}Weight controls the order in which profiles are presented when more than one profile is included in User Registration or My Account screens. Enter a positive or negative integer - lower numbers are displayed ahead of higher numbers.{/ts}
55 {/htxt}
56
57 {htxt id='id-help_pre-title'}
58 {ts}Help Pre-Form{/ts}
59 {/htxt}
60 {htxt id='id-help_pre'}
61 {ts}Explanatory text displayed at the beginning of the form.{/ts}{ts}Note that this help text is displayed on profile create/edit screens only.{/ts}
62 {/htxt}
63
64 {htxt id='id-help_post-title'}
65 {ts}Help Post-Form{/ts}
66 {/htxt}
67 {htxt id='id-help_post'}
68 {ts}Explanatory text displayed at the end of the form.{/ts}{ts}Note that this help text is displayed on profile create/edit screens only.{/ts}
69 {/htxt}
70
71 {htxt id='id-limit_group-title'}
72 {ts}Limit Group{/ts}
73 {/htxt}
74 {htxt id='id-limit_group'}
75 {ts}Select a group if you are using this profile for search and listings, AND you want to limit the listings to members of a specific group.{/ts}
76 {/htxt}
77
78 {htxt id='id-add_group-title'}
79 {ts}Add to Group{/ts}
80 {/htxt}
81 {htxt id='id-add_group'}
82 {ts}Select a group if you are using this profile for adding new contacts, AND you want the new contacts to be automatically assigned to a group.{/ts}
83 {/htxt}
84
85 {htxt id='id-notify_email-title'}
86 {ts}Notify Email{/ts}
87 {/htxt}
88 {htxt id='id-notify_email'}
89 {ts}If you want member(s) of your organization to receive a notification email whenever this Profile form is used to enter or update contact information, enter one or more email addresses here. Multiple email addresses should be separated by a comma (e.g. jane@example.org, paula@example.org). The first email address listed will be used as the FROM address in the notifications.{/ts}
90 {/htxt}
91
92 {htxt id='id-post_URL-title'}
93 {ts}Redirect{/ts}
94 {/htxt}
95 {htxt id='id-post_URL'}
96 {ts}If you are using this profile as a contact signup or edit form, and want to redirect the user to a static URL after they've submitted the form, you can also use contact tokens in URL - enter the complete URL here. If this field is left blank, the built-in Profile form will be redisplayed with a generic status message - 'Your contact information has been saved.'{/ts}
97 {/htxt}
98
99 {htxt id='id-cancel_URL-title'}
100 {ts}Cancel Redirect{/ts}
101 {/htxt}
102 {htxt id='id-cancel_URL'}
103 {ts}If you are using this profile as a contact signup or edit form, and want to redirect the user to a static URL if they click the Cancel button - enter the complete URL here. If this field is left blank, the built-in Profile form will be redisplayed.{/ts}
104 {/htxt}
105
106 {htxt id='id-add_captcha-title'}
107 {ts}reCaptcha{/ts}
108 {/htxt}
109 {htxt id='id-add_captcha'}
110 {capture assign="miscURL"}{crmURL p="civicrm/admin/setting/misc" q="reset=1"}{/capture}
111 <p>{ts}When reCAPTCHA is enabled for a profile form, anonymous users are required to read an image with letters and numbers and enter the value in a field. This helps prevent abuse by automated scripts.{/ts}</p>
112 <p>{ts 1="https://www.google.com/recaptcha" 2=$miscURL}To use reCAPTCHA you must sign up at <a href="%1" target="_blank">Google's reCaptcha site</a> to get your public and private keys. Then enter both keys in <a href="%2">Administer CiviCRM &raquo; System Settings &raquo; Misc (Undelete, PDFs, Limits, Logging, Captcha, etc.)</a>.{/ts}</p>
113 <p><strong>{ts}Do not enable this feature if you are using this profile as an HTML Form Snippet embedded in a non-CiviCRM web page. reCAPTCHA requires dynamic page generation. Submitting a stand-alone form with reCAPTCHA included will always result in a reCAPTCHA validation error.{/ts}</strong></p>
114 {if $config->userSystem->supports_form_extensions EQ '1'}
115 <p><strong>{ts}reCAPTCHA is also not available when a profile is used inside the User Registration and My Account screens.{/ts}</strong></p>
116 {/if}
117 {/htxt}
118
119 {htxt id='id-is_cms_user-title'}
120 {ts}Account Creation{/ts}
121 {/htxt}
122 {htxt id='id-is_cms_user'}
123 {ts 1=`$config->userFramework`}If you are using this profile as a contact signup form, using it in an online contribution page OR an event registration page, anonymous users will be given the option to create a %1 User Account as part of completing the form.{/ts}
124 {if $config->userSystem->is_drupal EQ '1'}
125 {ts}This feature requires your Drupal User Settings to allow 'vistors to create accounts' (with or without administrator approval). The 'Email Verification' option may be enabled or disabled.{/ts}
126 {ts}If the 'Email Verification' option is enabled, users will receive a welcome email from Drupal with login information. Otherwise they will select a Password inline, and if administrator approval is not required they will be automatically logged in as soon as the transaction is completed.{/ts}
127 {elseif $config->userFramework EQ 'Joomla'}
128 {ts}This feature requires the 'Allow User Registration' setting to be 'Yes' in Joomla Global Configuration >> System Settings.{/ts}
129 {/if}
130 {ts}In addition, you must include a Primary Email Address field in the profile.{/ts}
131 {/htxt}
132
133 {htxt id='id-is_update_dupe-title'}
134 {ts}Duplicate Matching{/ts}
135 {/htxt}
136 {htxt id='id-is_update_dupe'}
137 <p>{ts}If you are using the profile as a contact signup and editing form - this option controls what happens if the data matches an existing contact record. Using this option user can update the matching record or create a duplicate record or otherwise he will get a 'duplicate record' warning, and their input will not be saved. Contact matching is based on your configured 'Strict' rule for identifying duplicate contacts.{/ts} {docURL page="user/common-workflows/deduping-and-merging"}</p>
138 <p>{ts}This setting is ignored if the profile is embedded in an online contribution, membership signup or event registration form. In this case a contact match always results in the transaction being linked to the matching contact.</p>{/ts}
139 <p>{ts}In all cases, the check for an existing matching contact uses the default "Individual Strict Duplicate Matching Rule" (match on email address). If you are concerned with existing contact data being over-written by anonymous visitors, you can modify this rule to make matches less likely (or even impossible). For example, if you NEVER want anonymous input to match (i.e. always create a new contact record) - edit that rule and set the 'weight threshold' higher than 10. You will then need to run Find Duplicates periodically using a different rule, and merge any duplicate records with their associated memberships, contributions, etc.{/ts}</p>
140 <p>{ts}NOTE: If there are multiple matching contacts, the first matching record is used.{/ts}</p>
141 {/htxt}
142
143 {htxt id='id-is_map-title'}
144 {ts}Map Link{/ts}
145 {/htxt}
146 {htxt id='id-is_map'}
147 {ts}If enabled, a Map link is included on the profile listings rows and detail screens for any contacts whose records include sufficient location data for your mapping provider.{/ts}
148 {/htxt}
149
150 {htxt id='id-is_edit_link-title'}
151 {ts}Edit Link{/ts}
152 {/htxt}
153 {htxt id='id-is_edit_link'}
154 {ts}Check this box if you want to include a link in the listings to Edit profile fields. Only users with permission to edit the contact will see this link.{/ts}
155 {/htxt}
156
157 {htxt id='id-is_uf_link-title'}
158 {ts}User Link{/ts}
159 {/htxt}
160 {htxt id='id-is_uf_link'}
161 {ts 1=`$config->userFramework`}Check this box if you want to include a link in the listings to view contacts' %1 user account information (e.g. their 'My Account' page). This link will only be included for contacts who have a user account on your website.{/ts}
162 {/htxt}
163
164 {htxt id='id-is_proximity_search-title'}
165 {ts}Proximity Search{/ts}
166 {/htxt}
167 {htxt id='id-is_proximity_search'}
168 <p>
169 {ts}If you are using this profile as a search form, you can choose to include proximity searching. When enabled, a proximity search block will be added to the search criteria. This block will contain fields to set the proximity start address, and a field to set a 'Radius' (distance from that address).{/ts}
170 </p>
171 <p>
172 {ts}Set Proximity Search as required if you want all searches using this profile to require the user to enter a start address and a radius.{/ts}
173 </p>
174 <p>
175 {ts}IMPORTANT: You must enable a Mapping Provider in order to use the Proximity Search feature (Administer > System Settings > Mapping and Geocoding).{/ts}
176 </p>
177 {/htxt}