commit d4401083915c67085028785b99ae01768a446797 Author: ppound Date: Fri Jan 21 09:19:04 2022 -0400 initial roblib commit diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/README.txt b/README.txt new file mode 100644 index 0000000..8ef9818 --- /dev/null +++ b/README.txt @@ -0,0 +1,104 @@ + +Module: Google Analytics +Author: Alexander Hass + + +Description +=========== +Adds the Google Analytics tracking system to your website. + +Requirements +============ + +* Google Analytics user account + +Installation +============ +Copy the 'googleanalytics' module directory in to your Drupal +sites/all/modules directory as usual. + +Upgrading from 6.x-3.x and 7.x-1.x +================================== +If you upgrade from 6.x-3.x and 7.x-1.x (ga.js) to 7.x-2.x (analytics.js) you +should verify if you used custom variables. Write down your settings or make a +screenshot. You need to re-configure the settings to use custom dimensions or +metrics. There is no automatic upgrade path for custom variables feature. All +other module settings are upgraded automatically. + +See https://support.google.com/analytics/answer/2795983?hl=en for more details. + +Usage +===== +In the settings page enter your Google Analytics account number. + +All pages will now have the required JavaScript added to the +HTML footer can confirm this by viewing the page source from +your browser. + +Page specific tracking +====================== +The default is set to "Add to every page except the listed pages". By +default the following pages are listed for exclusion: + +admin +admin/* +batch +node/add* +node/*/* +user/*/* + +These defaults are changeable by the website administrator or any other +user with 'Administer Google Analytics' permission. + +Like the blocks visibility settings in Drupal core, there is a choice for +"Add if the following PHP code returns TRUE." Sample PHP snippets that can be +used in this textarea can be found on the handbook page "Overview-approach to +block visibility" at https://drupal.org/node/64135. + +Custom dimensions and metrics +============================= +One example for custom dimensions tracking is the "User roles" tracking. + +1. In the Google Analytics (https://marketingplatform.google.com/about/analytics/) + Management Interface you need to setup Dimension #1 with name + e.g. "User roles". This step is required. Do not miss it, please. + +2. Enter the below configuration data into the Drupal custom dimensions settings + form under admin/config/system/googleanalytics. You can also choose another + index, but keep it always in sync with the index used in step #1. + + Index: 1 + Value: [current-user:role-names] + +More details about custom dimensions and metrics can be found in the Google API +documentation at https://developers.google.com/analytics/devguides/collection/analyticsjs/custom-dims-mets + +Advanced Settings +================= +You can include additional JavaScript snippets in the custom javascript +code textarea. These can be found on the official Google Analytics pages +and a few examples at https://drupal.org/node/248699. Support is not +provided for any customisations you include. + +To speed up page loading you may also cache the Google Analytics "analytics.js" +file locally. + +Manual JS debugging +=================== +For manual debugging of the JS code you are able to create a test node. This +is the example HTML code for this test node. You need to enable debugging mode +in your Drupal configuration of Google Analytics settings to see verbose +messages in your browsers JS console. + +Title: Google Analytics test page + +Body: + + +Text format: Full HTML diff --git a/googleanalytics.admin.inc b/googleanalytics.admin.inc new file mode 100644 index 0000000..2d8afa3 --- /dev/null +++ b/googleanalytics.admin.inc @@ -0,0 +1,913 @@ + 'fieldset', + '#title' => t('General settings'), + ); + + $form['account']['googleanalytics_account'] = array( + '#title' => t('Web Property ID'), + '#type' => 'textfield', + '#default_value' => variable_get('googleanalytics_account', 'UA-'), + '#size' => 20, + '#maxlength' => 20, + '#required' => TRUE, + '#description' => t('This ID is unique to each site you want to track separately, and is in the form of UA-xxxxxxx-yy. To get a Web Property ID, register your site with Google Analytics, or if you already have registered your site, go to your Google Analytics Settings page to see the ID next to every site profile. Find more information in the documentation.', array('@analytics' => 'https://marketingplatform.google.com/about/analytics/', '@webpropertyid' => url('https://developers.google.com/analytics/resources/concepts/gaConceptsAccounts', array('fragment' => 'webProperty')))), + ); + + $form['account']['googleanalytics_premium'] = array( + '#type' => 'checkbox', + '#title' => t('Premium account'), + '#description' => t('If you are a Google Analytics Premium customer, you can use up to 200 instead of 20 custom dimensions and metrics.'), + '#default_value' => variable_get('googleanalytics_premium', FALSE), + ); + + // Visibility settings. + $form['tracking_title'] = array( + '#type' => 'item', + '#title' => t('Tracking scope'), + ); + $form['tracking'] = array( + '#type' => 'vertical_tabs', + '#attached' => array( + 'js' => array(drupal_get_path('module', 'googleanalytics') . '/googleanalytics.admin.js'), + ), + ); + + $form['tracking']['domain_tracking'] = array( + '#type' => 'fieldset', + '#title' => t('Domains'), + ); + + global $cookie_domain; + $multiple_sub_domains = array(); + foreach (array('www', 'app', 'shop') as $subdomain) { + if (count(explode('.', $cookie_domain)) > 2 && !is_numeric(str_replace('.', '', $cookie_domain))) { + $multiple_sub_domains[] = $subdomain . $cookie_domain; + } + // IP addresses or localhost. + else { + $multiple_sub_domains[] = $subdomain . '.example.com'; + } + } + + $multiple_toplevel_domains = array(); + foreach (array('.com', '.net', '.org') as $tldomain) { + $host = $_SERVER['HTTP_HOST']; + $domain = substr($host, 0, strrpos($host, '.')); + if (count(explode('.', $host)) > 2 && !is_numeric(str_replace('.', '', $host))) { + $multiple_toplevel_domains[] = $domain . $tldomain; + } + // IP addresses or localhost + else { + $multiple_toplevel_domains[] = 'www.example' . $tldomain; + } + } + + $form['tracking']['domain_tracking']['googleanalytics_domain_mode'] = array( + '#type' => 'radios', + '#title' => t('What are you tracking?'), + '#options' => array( + 0 => t('A single domain (default)') . '
' . t('Domain: @domain', array('@domain' => $_SERVER['HTTP_HOST'])) . '
', + 1 => t('One domain with multiple subdomains') . '
' . t('Examples: @domains', array('@domains' => implode(', ', $multiple_sub_domains))) . '
', + 2 => t('Multiple top-level domains') . '
' . t('Examples: @domains', array('@domains' => implode(', ', $multiple_toplevel_domains))) . '
', + ), + '#default_value' => variable_get('googleanalytics_domain_mode', 0), + ); + $form['tracking']['domain_tracking']['googleanalytics_cross_domains'] = array( + '#title' => t('List of top-level domains'), + '#type' => 'textarea', + '#default_value' => variable_get('googleanalytics_cross_domains', ''), + '#description' => t('If you selected "Multiple top-level domains" above, enter all related top-level domains. Add one domain per line. By default, the data in your reports only includes the path and name of the page, and not the domain name. For more information see section Show separate domain names in Tracking Multiple Domains.', array('@url' => 'https://support.google.com/analytics/answer/1034342')), + '#states' => array( + 'enabled' => array( + ':input[name="googleanalytics_domain_mode"]' => array('value' => '2'), + ), + 'required' => array( + ':input[name="googleanalytics_domain_mode"]' => array('value' => '2'), + ), + ), + ); + + // Page specific visibility configurations. + $php_access = user_access('use PHP for tracking visibility'); + $visibility = variable_get('googleanalytics_visibility_pages', 0); + $pages = variable_get('googleanalytics_pages', GOOGLEANALYTICS_PAGES); + + $form['tracking']['page_vis_settings'] = array( + '#type' => 'fieldset', + '#title' => t('Pages'), + '#collapsible' => TRUE, + '#collapsed' => TRUE, + ); + + if ($visibility == 2 && !$php_access) { + $form['tracking']['page_vis_settings'] = array(); + $form['tracking']['page_vis_settings']['googleanalytics_visibility_pages'] = array('#type' => 'value', '#value' => 2); + $form['tracking']['page_vis_settings']['googleanalytics_pages'] = array('#type' => 'value', '#value' => $pages); + } + else { + $options = array( + t('Every page except the listed pages'), + t('The listed pages only'), + ); + $description = t("Specify pages by using their paths. Enter one path per line. The '*' character is a wildcard. Example paths are %blog for the blog page and %blog-wildcard for every personal blog. %front is the front page.", array('%blog' => 'blog', '%blog-wildcard' => 'blog/*', '%front' => '')); + + if (module_exists('php') && $php_access) { + $options[] = t('Pages on which this PHP code returns TRUE (experts only)'); + $title = t('Pages or PHP code'); + $description .= ' ' . t('If the PHP option is chosen, enter PHP code between %php. Note that executing incorrect PHP code can break your Drupal site.', array('%php' => '')); + } + else { + $title = t('Pages'); + } + $form['tracking']['page_vis_settings']['googleanalytics_visibility_pages'] = array( + '#type' => 'radios', + '#title' => t('Add tracking to specific pages'), + '#options' => $options, + '#default_value' => $visibility, + ); + $form['tracking']['page_vis_settings']['googleanalytics_pages'] = array( + '#type' => 'textarea', + '#title' => $title, + '#title_display' => 'invisible', + '#default_value' => $pages, + '#description' => $description, + '#rows' => 10, + ); + } + + // Render the role overview. + $form['tracking']['role_vis_settings'] = array( + '#type' => 'fieldset', + '#title' => t('Roles'), + ); + + $form['tracking']['role_vis_settings']['googleanalytics_visibility_roles'] = array( + '#type' => 'radios', + '#title' => t('Add tracking for specific roles'), + '#options' => array( + t('Add to the selected roles only'), + t('Add to every role except the selected ones'), + ), + '#default_value' => variable_get('googleanalytics_visibility_roles', 0), + ); + + $role_options = array_map('check_plain', user_roles()); + $form['tracking']['role_vis_settings']['googleanalytics_roles'] = array( + '#type' => 'checkboxes', + '#title' => t('Roles'), + '#default_value' => variable_get('googleanalytics_roles', array()), + '#options' => $role_options, + '#description' => t('If none of the roles are selected, all users will be tracked. If a user has any of the roles checked, that user will be tracked (or excluded, depending on the setting above).'), + ); + + // Standard tracking configurations. + $form['tracking']['user_vis_settings'] = array( + '#type' => 'fieldset', + '#title' => t('Users'), + ); + $t_permission = array('%permission' => t('Opt-in or out of tracking')); + $form['tracking']['user_vis_settings']['googleanalytics_custom'] = array( + '#type' => 'radios', + '#title' => t('Allow users to customize tracking on their account page'), + '#options' => array( + t('No customization allowed'), + t('Tracking on by default, users with %permission permission can opt out', $t_permission), + t('Tracking off by default, users with %permission permission can opt in', $t_permission), + ), + '#default_value' => variable_get('googleanalytics_custom', 0), + ); + $form['tracking']['user_vis_settings']['googleanalytics_trackuserid'] = array( + '#type' => 'checkbox', + '#title' => t('Track User ID'), + '#default_value' => variable_get('googleanalytics_trackuserid', 0), + '#description' => t('User ID enables the analysis of groups of sessions, across devices, using a unique, persistent, and non-personally identifiable ID string representing a user. Learn more about the benefits of using User ID.', array('@url' => 'https://support.google.com/analytics/answer/3123663')), + ); + + // Link specific configurations. + $form['tracking']['linktracking'] = array( + '#type' => 'fieldset', + '#title' => t('Links and downloads'), + ); + $form['tracking']['linktracking']['googleanalytics_trackoutbound'] = array( + '#type' => 'checkbox', + '#title' => t('Track clicks on outbound links'), + '#default_value' => variable_get('googleanalytics_trackoutbound', 1), + ); + $form['tracking']['linktracking']['googleanalytics_trackmailto'] = array( + '#type' => 'checkbox', + '#title' => t('Track clicks on mailto links'), + '#default_value' => variable_get('googleanalytics_trackmailto', 1), + ); + $form['tracking']['linktracking']['googleanalytics_trackfiles'] = array( + '#type' => 'checkbox', + '#title' => t('Track downloads (clicks on file links) for the following extensions'), + '#default_value' => variable_get('googleanalytics_trackfiles', 1), + ); + $form['tracking']['linktracking']['googleanalytics_trackfiles_extensions'] = array( + '#title' => t('List of download file extensions'), + '#title_display' => 'invisible', + '#type' => 'textfield', + '#default_value' => variable_get('googleanalytics_trackfiles_extensions', GOOGLEANALYTICS_TRACKFILES_EXTENSIONS), + '#description' => t('A file extension list separated by the | character that will be tracked as download when clicked. Regular expressions are supported. For example: !extensions', array('!extensions' => GOOGLEANALYTICS_TRACKFILES_EXTENSIONS)), + '#maxlength' => 500, + '#states' => array( + 'enabled' => array( + ':input[name="googleanalytics_trackfiles"]' => array('checked' => TRUE), + ), + // Note: Form required marker is not visible as title is invisible. + 'required' => array( + ':input[name="googleanalytics_trackfiles"]' => array('checked' => TRUE), + ), + ), + ); + + $colorbox_dependencies = '
'; + $colorbox_dependencies .= t('Requires: !module-list', array('!module-list' => (module_exists('colorbox') ? t('@module (enabled)', array('@module' => 'Colorbox')) : t('@module (disabled)', array('@module' => 'Colorbox'))))); + $colorbox_dependencies .= '
'; + + $form['tracking']['linktracking']['googleanalytics_trackcolorbox'] = array( + '#type' => 'checkbox', + '#title' => t('Track content in colorbox modal dialogs'), + '#default_value' => variable_get('googleanalytics_trackcolorbox', 1), + '#description' => t('Enable to track the content shown in colorbox modal windows.') . $colorbox_dependencies, + '#disabled' => (module_exists('colorbox') ? FALSE : TRUE), + ); + $form['tracking']['linktracking']['googleanalytics_tracklinkid'] = array( + '#type' => 'checkbox', + '#title' => t('Track enhanced link attribution'), + '#default_value' => variable_get('googleanalytics_tracklinkid', 0), + '#description' => t('Enhanced Link Attribution improves the accuracy of your In-Page Analytics report by automatically differentiating between multiple links to the same URL on a single page by using link element IDs. Enable enhanced link attribution in the Admin UI of your Google Analytics account.', array('@url' => 'https://support.google.com/analytics/answer/2558867')), + ); + $form['tracking']['linktracking']['googleanalytics_trackurlfragments'] = array( + '#type' => 'checkbox', + '#title' => t('Track changing URL fragments as pageviews'), + '#default_value' => variable_get('googleanalytics_trackurlfragments', 0), + '#description' => t('By default, the URL reported to Google Analytics will not include the "fragment identifier" (i.e. the portion of the URL beginning with a hash sign), and hash changes by themselves will not cause new pageviews to be reported. Checking this box will cause hash changes to be reported as pageviews (in modern browsers) and all pageview URLs to include the fragment where applicable.'), + ); + + // Message specific configurations. + $form['tracking']['messagetracking'] = array( + '#type' => 'fieldset', + '#title' => t('Messages'), + ); + $form['tracking']['messagetracking']['googleanalytics_trackmessages'] = array( + '#type' => 'checkboxes', + '#title' => t('Track messages of type'), + '#default_value' => variable_get('googleanalytics_trackmessages', array()), + '#description' => t('This will track the selected message types shown to users. Tracking of form validation errors may help you identifying usability issues in your site. For each visit (user session), a maximum of approximately 500 combined GATC requests (both events and page views) can be tracked. Every message is tracked as one individual event. Note that - as the number of events in a session approaches the limit - additional events might not be tracked. Messages from excluded pages cannot be tracked.'), + '#options' => array( + 'status' => t('Status message'), + 'warning' => t('Warning message'), + 'error' => t('Error message'), + ), + ); + + $form['tracking']['search_and_advertising'] = array( + '#type' => 'fieldset', + '#title' => t('Search and Advertising'), + ); + + $site_search_dependencies = '
'; + $site_search_dependencies .= t('Requires: !module-list', array('!module-list' => (module_exists('search') ? t('@module (enabled)', array('@module' => 'Search')) : t('@module (disabled)', array('@module' => 'Search'))))); + $site_search_dependencies .= '
'; + + $form['tracking']['search_and_advertising']['googleanalytics_site_search'] = array( + '#type' => 'checkbox', + '#title' => t('Track internal search'), + '#description' => t('If checked, internal search keywords are tracked. You must configure your Google account to use the internal query parameter search. For more information see Setting Up Site Search for a Profile.', array('@url' => 'https://support.google.com/analytics/answer/1012264')) . $site_search_dependencies, + '#default_value' => variable_get('googleanalytics_site_search', FALSE), + '#disabled' => (module_exists('search') ? FALSE : TRUE), + ); + $form['tracking']['search_and_advertising']['googleanalytics_trackadsense'] = array( + '#type' => 'checkbox', + '#title' => t('Track AdSense ads'), + '#description' => t('If checked, your AdSense ads will be tracked in your Google Analytics account.'), + '#default_value' => variable_get('googleanalytics_trackadsense', FALSE), + ); + $form['tracking']['search_and_advertising']['googleanalytics_trackdoubleclick'] = array( + '#type' => 'checkbox', + '#title' => t('Track display features'), + '#description' => t('The display features plugin can be used to enable Display Advertising Features in Google Analytics, such as Remarketing, Demographics and Interest Reporting, and more. Learn more about Display Advertising Features in Google Analytics. If you choose this option you will need to update your privacy policy.', array('@displayfeatures' => 'https://support.google.com/analytics/answer/3450482', '@privacy' => 'https://support.google.com/analytics/answer/2700409')), + '#default_value' => variable_get('googleanalytics_trackdoubleclick', FALSE), + ); + + // Privacy specific configurations. + $form['tracking']['privacy'] = array( + '#type' => 'fieldset', + '#title' => t('Privacy'), + ); + $form['tracking']['privacy']['googleanalytics_tracker_anonymizeip'] = array( + '#type' => 'checkbox', + '#title' => t('Anonymize visitors IP address'), + '#description' => t('Tell Google Analytics to anonymize the information sent by the tracker objects by removing the last octet of the IP address prior to its storage. Note that this will slightly reduce the accuracy of geographic reporting. In some countries it is not allowed to collect personally identifying information for privacy reasons and this setting may help you to comply with the local laws.'), + '#default_value' => variable_get('googleanalytics_tracker_anonymizeip', 1), + ); + $form['tracking']['privacy']['googleanalytics_privacy_donottrack'] = array( + '#type' => 'checkbox', + '#title' => t('Universal web tracking opt-out'), + '#description' => t('If enabled and your server receives the Do-Not-Track header from the client browser, the Google Analytics module will not embed any tracking code into your site. Compliance with Do Not Track could be purely voluntary, enforced by industry self-regulation, or mandated by state or federal law. Please accept your visitors privacy. If they have opt-out from tracking and advertising, you should accept their personal decision. This feature is currently limited to logged in users and disabled page caching.', array('@donottrack' => 'https://www.eff.org/issues/do-not-track')), + '#default_value' => variable_get('googleanalytics_privacy_donottrack', 1), + ); + + // Custom Dimensions. + $form['googleanalytics_custom_dimension'] = array( + '#collapsed' => TRUE, + '#collapsible' => TRUE, + '#description' => t('You can set values for Google Analytics Custom Dimensions here. You must have already configured your custom dimensions in the Google Analytics Management Interface. You may use tokens. Global and user tokens are always available; on node pages, node tokens are also available. A dimension value is allowed to have a maximum length of 150 bytes. Expect longer values to get trimmed.', array('@custom_var_documentation' => 'https://developers.google.com/analytics/devguides/collection/analyticsjs/custom-dims-mets', '@setup_documentation' => 'https://support.google.com/analytics/answer/2709829')), + '#theme' => 'googleanalytics_admin_custom_var_table', + '#title' => t('Custom dimensions'), + '#tree' => TRUE, + '#type' => 'fieldset', + ); + + $googleanalytics_custom_dimension = variable_get('googleanalytics_custom_dimension', array()); + + // Standard Google Analytics accounts support up to 20 custom dimensions, + // premium accounts support up to 200 custom dimensions. + $limit = (variable_get('googleanalytics_premium', FALSE)) ? 200 : 20; + for ($i = 1; $i <= $limit; $i++) { + $form['googleanalytics_custom_dimension']['indexes'][$i]['index'] = array( + '#default_value' => $i, + '#description' => t('Index number'), + '#disabled' => TRUE, + '#size' => 1, + '#title' => t('Custom dimension index #@index', array('@index' => $i)), + '#title_display' => 'invisible', + '#type' => 'textfield', + ); + $form['googleanalytics_custom_dimension']['indexes'][$i]['value'] = array( + '#default_value' => isset($googleanalytics_custom_dimension[$i]['value']) ? $googleanalytics_custom_dimension[$i]['value'] : '', + '#description' => t('The custom dimension value.'), + '#maxlength' => 255, + '#title' => t('Custom dimension value #@index', array('@index' => $i)), + '#title_display' => 'invisible', + '#type' => 'textfield', + '#element_validate' => array('googleanalytics_token_element_validate'), + '#token_types' => array('node'), + ); + if (module_exists('token')) { + $form['googleanalytics_custom_dimension']['indexes'][$i]['value']['#element_validate'][] = 'token_element_validate'; + } + } + + $form['googleanalytics_custom_dimension']['googleanalytics_description'] = array( + '#type' => 'item', + '#description' => t('You can supplement Google Analytics\' basic IP address tracking of visitors by segmenting users based on custom dimensions. Section 7 of the Google Analytics terms of service requires that You will not (and will not allow any third party to) use the Service to track, collect or upload any data that personally identifies an individual (such as a name, userid, email address or billing information), or other data which can be reasonably linked to such information by Google. You will have and abide by an appropriate Privacy Policy and will comply with all applicable laws and regulations relating to the collection of information from Visitors. You must post a Privacy Policy and that Privacy Policy must provide notice of Your use of cookies that are used to collect traffic data, and You must not circumvent any privacy features (e.g., an opt-out) that are part of the Service.', array('@ga_tos' => 'https://www.google.com/analytics/terms/gb.html')), + ); + if (module_exists('token')) { + $form['googleanalytics_custom_dimension']['googleanalytics_token_tree'] = array( + '#theme' => 'token_tree', + '#token_types' => array('node'), + '#dialog' => TRUE, + ); + } + + // Custom Metrics. + $form['googleanalytics_custom_metric'] = array( + '#collapsed' => TRUE, + '#collapsible' => TRUE, + '#description' => t('You can add Google Analytics Custom Metrics here. You must have already configured your custom metrics in the Google Analytics Management Interface. You may use tokens. Global and user tokens are always available; on node pages, node tokens are also available.', array('@custom_var_documentation' => 'https://developers.google.com/analytics/devguides/collection/analyticsjs/custom-dims-mets', '@setup_documentation' => 'https://support.google.com/analytics/answer/2709829')), + '#theme' => 'googleanalytics_admin_custom_var_table', + '#title' => t('Custom metrics'), + '#tree' => TRUE, + '#type' => 'fieldset', + ); + + $googleanalytics_custom_metric = variable_get('googleanalytics_custom_metric', array()); + + // Standard Google Analytics accounts support up to 20 custom metrics, + // premium accounts support up to 200 custom metrics. + for ($i = 1; $i <= $limit; $i++) { + $form['googleanalytics_custom_metric']['indexes'][$i]['index'] = array( + '#default_value' => $i, + '#description' => t('Index number'), + '#disabled' => TRUE, + '#size' => 1, + '#title' => t('Custom metric index #@index', array('@index' => $i)), + '#title_display' => 'invisible', + '#type' => 'textfield', + ); + $form['googleanalytics_custom_metric']['indexes'][$i]['value'] = array( + '#default_value' => isset($googleanalytics_custom_metric[$i]['value']) ? $googleanalytics_custom_metric[$i]['value'] : '', + '#description' => t('The custom metric value.'), + '#maxlength' => 255, + '#title' => t('Custom metric value #@index', array('@index' => $i)), + '#title_display' => 'invisible', + '#type' => 'textfield', + '#element_validate' => array('googleanalytics_token_element_validate'), + '#token_types' => array('node'), + ); + if (module_exists('token')) { + $form['googleanalytics_custom_metric']['indexes'][$i]['value']['#element_validate'][] = 'token_element_validate'; + } + } + + $form['googleanalytics_custom_metric']['googleanalytics_description'] = array( + '#type' => 'item', + '#description' => t('You can supplement Google Analytics\' basic IP address tracking of visitors by segmenting users based on custom metrics. Section 7 of the Google Analytics terms of service requires that You will not (and will not allow any third party to) use the Service to track, collect or upload any data that personally identifies an individual (such as a name, userid, email address or billing information), or other data which can be reasonably linked to such information by Google. You will have and abide by an appropriate Privacy Policy and will comply with all applicable laws and regulations relating to the collection of information from Visitors. You must post a Privacy Policy and that Privacy Policy must provide notice of Your use of cookies that are used to collect traffic data, and You must not circumvent any privacy features (e.g., an opt-out) that are part of the Service.', array('@ga_tos' => 'https://www.google.com/analytics/terms/gb.html')), + ); + if (module_exists('token')) { + $form['googleanalytics_custom_metric']['googleanalytics_token_tree'] = array( + '#theme' => 'token_tree', + '#token_types' => array('node'), + '#dialog' => TRUE, + ); + } + + // Advanced feature configurations. + $form['advanced'] = array( + '#type' => 'fieldset', + '#title' => t('Advanced settings'), + '#collapsible' => TRUE, + '#collapsed' => TRUE, + ); + + $form['advanced']['googleanalytics_cache'] = array( + '#type' => 'checkbox', + '#title' => t('Locally cache tracking code file'), + '#description' => t("If checked, the tracking code file is retrieved from Google Analytics and cached locally. It is updated daily from Google's servers to ensure updates to tracking code are reflected in the local copy. Do not activate this until after Google Analytics has confirmed that site tracking is working!"), + '#default_value' => variable_get('googleanalytics_cache', 0), + ); + + // Allow for tracking of the originating node when viewing translation sets. + if (module_exists('translation')) { + $form['advanced']['googleanalytics_translation_set'] = array( + '#type' => 'checkbox', + '#title' => t('Track translation sets as one unit'), + '#description' => t('When a node is part of a translation set, record statistics for the originating node instead. This allows for a translation set to be treated as a single unit.'), + '#default_value' => variable_get('googleanalytics_translation_set', 0), + ); + } + + $user_access_add_js_snippets = !user_access('add JS snippets for google analytics'); + $user_access_add_js_snippets_permission_warning = $user_access_add_js_snippets ? ' ' . t('This field has been disabled because you do not have sufficient permissions to edit it.') . '' : ''; + $form['advanced']['codesnippet'] = array( + '#type' => 'fieldset', + '#title' => t('Custom JavaScript code'), + '#collapsible' => TRUE, + '#collapsed' => TRUE, + '#description' => t('You can add custom Google Analytics code snippets here. These will be added every time tracking is in effect. Before you add your custom code, you should read the Google Analytics Tracking Code - Functional Overview and the Google Analytics Tracking API documentation. Do not include the <script> tags, and always end your code with a semicolon (;).', array('@snippets' => 'https://drupal.org/node/248699', '@ga_concepts_overview' => 'https://developers.google.com/analytics/resources/concepts/gaConceptsTrackingOverview', '@ga_js_api' => 'https://developers.google.com/analytics/devguides/collection/analyticsjs/method-reference')), + ); + $form['advanced']['codesnippet']['googleanalytics_codesnippet_create'] = array( + '#type' => 'textarea', + '#title' => t('Create only fields'), + '#default_value' => _googleanalytics_get_name_value_string(variable_get('googleanalytics_codesnippet_create', array())), + '#rows' => 5, + '#description' => t('Enter one value per line, in the format name|value. Settings in this textarea will be added to ga("create", "UA-XXXX-Y", {"name":"value"});. For more information, read create only fields documentation in the Analytics.js field reference.', array('@url' => 'https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#create')), + '#element_validate' => array('googleanalytics_validate_create_field_values'), + ); + $form['advanced']['codesnippet']['googleanalytics_codesnippet_before'] = array( + '#type' => 'textarea', + '#title' => t('Code snippet (before)'), + '#default_value' => variable_get('googleanalytics_codesnippet_before', ''), + '#disabled' => $user_access_add_js_snippets, + '#rows' => 5, + '#description' => t('Code in this textarea will be added before ga("send", "pageview");.') . $user_access_add_js_snippets_permission_warning, + ); + $form['advanced']['codesnippet']['googleanalytics_codesnippet_after'] = array( + '#type' => 'textarea', + '#title' => t('Code snippet (after)'), + '#default_value' => variable_get('googleanalytics_codesnippet_after', ''), + '#disabled' => $user_access_add_js_snippets, + '#rows' => 5, + '#description' => t('Code in this textarea will be added after ga("send", "pageview");. This is useful if you\'d like to track a site in two accounts.') . $user_access_add_js_snippets_permission_warning, + ); + + $form['advanced']['googleanalytics_debug'] = array( + '#type' => 'checkbox', + '#title' => t('Enable debugging'), + '#description' => t('If checked, the Google Universal Analytics debugging script will be loaded. You should not enable your production site to use this version of the JavaScript. The analytics_debug.js script is larger than the analytics.js tracking code and it is not typically cached. Using it in your production site will slow down your site for all of your users. Again, this is only for your own testing purposes. Debug messages are printed to the window.console object.'), + '#default_value' => variable_get('googleanalytics_debug', 0), + ); + + return system_settings_form($form); +} + +/** + * Implements _form_validate(). + */ +function googleanalytics_admin_settings_form_validate($form, &$form_state) { + // Trim custom dimensions and metrics. + foreach ($form_state['values']['googleanalytics_custom_dimension']['indexes'] as $dimension) { + $form_state['values']['googleanalytics_custom_dimension']['indexes'][$dimension['index']]['value'] = trim($dimension['value']); + // Remove empty values from the array. + if (!drupal_strlen($form_state['values']['googleanalytics_custom_dimension']['indexes'][$dimension['index']]['value'])) { + unset($form_state['values']['googleanalytics_custom_dimension']['indexes'][$dimension['index']]); + } + } + $form_state['values']['googleanalytics_custom_dimension'] = $form_state['values']['googleanalytics_custom_dimension']['indexes']; + + foreach ($form_state['values']['googleanalytics_custom_metric']['indexes'] as $metric) { + $form_state['values']['googleanalytics_custom_metric']['indexes'][$metric['index']]['value'] = trim($metric['value']); + // Remove empty values from the array. + if (!drupal_strlen($form_state['values']['googleanalytics_custom_metric']['indexes'][$metric['index']]['value'])) { + unset($form_state['values']['googleanalytics_custom_metric']['indexes'][$metric['index']]); + } + } + $form_state['values']['googleanalytics_custom_metric'] = $form_state['values']['googleanalytics_custom_metric']['indexes']; + + // Trim some text values. + $form_state['values']['googleanalytics_account'] = trim($form_state['values']['googleanalytics_account']); + $form_state['values']['googleanalytics_pages'] = trim($form_state['values']['googleanalytics_pages']); + $form_state['values']['googleanalytics_cross_domains'] = trim($form_state['values']['googleanalytics_cross_domains']); + $form_state['values']['googleanalytics_codesnippet_create'] = _googleanalytics_extract_create_field_values($form_state['values']['googleanalytics_codesnippet_create']); + $form_state['values']['googleanalytics_codesnippet_before'] = trim($form_state['values']['googleanalytics_codesnippet_before']); + $form_state['values']['googleanalytics_codesnippet_after'] = trim($form_state['values']['googleanalytics_codesnippet_after']); + + // Replace all type of dashes (n-dash, m-dash, minus) with the normal dashes. + $form_state['values']['googleanalytics_account'] = str_replace(array('–', '—', '−'), '-', $form_state['values']['googleanalytics_account']); + + if (!preg_match('/^UA-\d+-\d+$/', $form_state['values']['googleanalytics_account'])) { + form_set_error('googleanalytics_account', t('A valid Google Analytics Web Property ID is case sensitive and formatted like UA-xxxxxxx-yy.')); + } + + // If multiple top-level domains has been selected, a domain names list is required. + if ($form_state['values']['googleanalytics_domain_mode'] == 2 && empty($form_state['values']['googleanalytics_cross_domains'])) { + form_set_error('googleanalytics_cross_domains', t('A list of top-level domains is required if Multiple top-level domains has been selected.')); + } + // Clear the domain list if cross domains are disabled. + if ($form_state['values']['googleanalytics_domain_mode'] != 2) { + $form_state['values']['googleanalytics_cross_domains'] = ''; + } + + // Disallow empty list of download file extensions. + if ($form_state['values']['googleanalytics_trackfiles'] && empty($form_state['values']['googleanalytics_trackfiles_extensions'])) { + form_set_error('googleanalytics_trackfiles_extensions', t('List of download file extensions cannot empty.')); + } + // Clear obsolete local cache if cache has been disabled. + if (empty($form_state['values']['googleanalytics_cache']) && $form['advanced']['googleanalytics_cache']['#default_value']) { + googleanalytics_clear_js_cache(); + } + + // This is for the Newbie's who cannot read a text area description. + if (stristr($form_state['values']['googleanalytics_codesnippet_before'], 'google-analytics.com/analytics.js')) { + form_set_error('googleanalytics_codesnippet_before', t('Do not add the tracker code provided by Google into the javascript code snippets! This module already builds the tracker code based on your Google Analytics account number and settings.')); + } + if (stristr($form_state['values']['googleanalytics_codesnippet_after'], 'google-analytics.com/analytics.js')) { + form_set_error('googleanalytics_codesnippet_after', t('Do not add the tracker code provided by Google into the javascript code snippets! This module already builds the tracker code based on your Google Analytics account number and settings.')); + } + if (preg_match('/(.*)<\/?script(.*)>(.*)/i', $form_state['values']['googleanalytics_codesnippet_before'])) { + form_set_error('googleanalytics_codesnippet_before', t('Do not include the <script> tags in the javascript code snippets.')); + } + if (preg_match('/(.*)<\/?script(.*)>(.*)/i', $form_state['values']['googleanalytics_codesnippet_after'])) { + form_set_error('googleanalytics_codesnippet_after', t('Do not include the <script> tags in the javascript code snippets.')); + } +} + +/** + * Layout for the custom variables table in the admin settings form. + * + * @param array $variables + * An array contains the form elements. + * + * @return string + * The rendered output. + */ +function theme_googleanalytics_admin_custom_var_table($variables) { + $form = $variables['form']; + + $header = array( + array('data' => t('Index')), + array('data' => t('Value')), + ); + + $rows = array(); + foreach (element_children($form['indexes']) as $id) { + $rows[] = array( + 'data' => array( + drupal_render($form['indexes'][$id]['index']), + drupal_render($form['indexes'][$id]['value']), + ), + ); + } + + $output = theme('table', array('header' => $header, 'rows' => $rows)); + $output .= drupal_render($form['googleanalytics_description']); + if (isset($form['googleanalytics_token_tree'])) { + $output .= drupal_render($form['googleanalytics_token_tree']); + } + + return $output; +} + +/** + * Validate a form element that should have tokens in it. + * + * For example: + * @code + * $form['my_node_text_element'] = array( + * '#type' => 'textfield', + * '#title' => t('Some text to token-ize that has a node context.'), + * '#default_value' => 'The title of this node is [node:title].', + * '#element_validate' => array('googleanalytics_token_element_validate'), + * ); + * @endcode + */ +function googleanalytics_token_element_validate(&$element, &$form_state) { + $value = isset($element['#value']) ? $element['#value'] : $element['#default_value']; + + if (!drupal_strlen($value)) { + // Empty value needs no further validation since the element should depend + // on using the '#required' FAPI property. + return $element; + } + + $tokens = token_scan($value); + $invalid_tokens = _googleanalytics_get_forbidden_tokens($tokens); + if ($invalid_tokens) { + form_error($element, t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => $element['#title'], '@invalid-tokens' => implode(', ', $invalid_tokens)))); + } + + return $element; +} + +/** + * @param array $value + * An array of token values. + * + * @return array + * A unique array of invalid tokens. + */ +function _googleanalytics_get_forbidden_tokens($value) { + $invalid_tokens = array(); + $value_tokens = is_string($value) ? token_scan($value) : $value; + + foreach ($value_tokens as $tokens) { + if (array_filter($tokens, '_googleanalytics_contains_forbidden_token')) { + $invalid_tokens = array_merge($invalid_tokens, array_values($tokens)); + } + } + + array_unique($invalid_tokens); + return $invalid_tokens; +} + +/** + * Validate if a string contains forbidden tokens not allowed by privacy rules. + * + * @param string $token_string + * A string with one or more tokens to be validated. + * + * @return boolean + * TRUE if blacklisted token has been found, otherwise FALSE. + */ +function _googleanalytics_contains_forbidden_token($token_string) { + // List of strings in tokens with personal identifying information not allowed + // for privacy reasons. See section 8.1 of the Google Analytics terms of use + // for more detailed information. + // + // This list can never ever be complete. For this reason it tries to use a + // regex and may kill a few other valid tokens, but it's the only way to + // protect users as much as possible from admins with illegal ideas. + // + // User tokens are not prefixed with colon to catch 'current-user' and 'user'. + // + // TODO: If someone have better ideas, share them, please! + $token_blacklist = array( + ':author]', + ':author:edit-url]', + ':author:url]', + ':author:path]', + ':current-user]', + ':current-user:original]', + ':fid]', + ':mail]', + ':name]', + ':uid]', + ':one-time-login-url]', + ':owner]', + ':owner:cancel-url]', + ':owner:edit-url]', + ':owner:url]', + ':owner:path]', + 'user:cancel-url]', + 'user:edit-url]', + 'user:url]', + 'user:path]', + 'user:picture]', + // addressfield_tokens.module + ':first-name]', + ':last-name]', + ':name-line]', + ':mc-address]', + ':thoroughfare]', + ':premise]', + // realname.module + ':name-raw]', + // token.module + ':ip-address]', + ); + + return preg_match('/' . implode('|', array_map('preg_quote', $token_blacklist)) . '/i', $token_string); +} + +/** + * #element_validate callback for create only fields. + * + * @param $element + * An associative array containing the properties and children of the + * generic form element. + * @param $form_state + * The $form_state array for the form this element belongs to. + * + * @see form_process_pattern() + */ +function googleanalytics_validate_create_field_values(&$element, &$form_state) { + $values = _googleanalytics_extract_create_field_values($element['#value']); + + if (!is_array($values)) { + form_error($element, t('The %element-title field contains invalid input.', array('%element-title' => $element['#title']))); + } + else { + // Check that name and value are valid for the field type. + foreach ($values as $name => $value) { + if ($error = _googleanalytics_validate_create_field_name($name)) { + form_error($element, $error); + break; + } + if ($error = _googleanalytics_validate_create_field_value($value)) { + form_error($element, $error); + break; + } + } + + return $element; + } +} + +/** + * Extracts the values array from the element. + * + * @param string $string + * The raw string to extract values from. + * + * @return array|null + * The array of extracted key/value pairs, or NULL if the string is invalid. + * + * @see \Drupal\options\Plugin\Field\FieldType\ListTextItem::allowedValuesString() + */ +function _googleanalytics_extract_create_field_values($string) { + $values = array(); + + $list = explode("\n", $string); + $list = array_map('trim', $list); + $list = array_filter($list, 'strlen'); + + foreach ($list as $text) { + // Check for an explicit key. + $matches = array(); + if (preg_match('/(.*)\|(.*)/', $text, $matches)) { + // Trim key and value to avoid unwanted spaces issues. + $name = trim($matches[1]); + $value = trim($matches[2]); + } + else { + return; + } + + $values[$name] = $value; + } + + return _googleanalytics_convert_form_value_data_types($values); +} + +/** + * Checks whether a field name is valid. + * + * @param string $name + * The option value entered by the user. + * + * @return string + * The error message if the specified value is invalid, NULL otherwise. + */ +function _googleanalytics_validate_create_field_name($name) { + // List of supported field names: + // https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#create + $create_only_fields = array( + 'allowAnchor', + 'alwaysSendReferrer', + 'clientId', + 'cookieName', + 'cookieDomain', + 'cookieExpires', + 'legacyCookieDomain', + 'legacyHistoryImport', + 'sampleRate', + 'siteSpeedSampleRate', + 'storage', + 'useAmpClientId', + ); + + if ($name == 'name') { + return t('Create only field name %name is a disallowed field name. Changing the Tracker Name is currently not supported.', array('%name' => $name)); + } + if ($name == 'allowLinker') { + return t('Create only field name %name is a disallowed field name. Please select Multiple top-level domains under What are you tracking to enable cross domain tracking.', array('%name' => $name)); + } + if ($name == 'userId') { + return t('Create only field name %name is a disallowed field name. Please enable Track User ID under Tracking scope > Users.', array('%name' => $name)); + } + if (!in_array($name, $create_only_fields)) { + return t('Create only field name %name is an unknown field name. Field names are case sensitive. Please see create only fields documentation for supported field names.', array('%name' => $name, '@url' => 'https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#create')); + } +} + +/** + * Checks whether a field value is valid. + * + * @param string $value + * The option value entered by the user. + * + * @return string + * The error message if the specified value is invalid, NULL otherwise. + */ +function _googleanalytics_validate_create_field_value($value) { + if (!is_bool($value) && !drupal_strlen($value)) { + return t('A create only field requires a value.'); + } + if (drupal_strlen($value) > 255) { + return t('The value of a create only field must be a string at most 255 characters long.'); + } +} + +/** + * Generates a string representation of an array. + * + * This string format is suitable for edition in a textarea. + * + * @param array $values + * An array of values, where array keys are values and array values are + * labels. + * + * @return string + * The string representation of the $values array: + * - Values are separated by a carriage return. + * - Each value is in the format "name|value" or "value". + */ +function _googleanalytics_get_name_value_string($values) { + $lines = array(); + foreach ($values as $name => $value) { + // Convert data types. + // @todo: #2251377: Json utility class serializes boolean values to incorrect data type + if (is_bool($value)) { + $value = ($value) ? 'true' : 'false'; + } + + $lines[] = "$name|$value"; + } + return implode("\n", $lines); +} + +/** + * Prepare form data types for Json conversion. + * + * @param array $values + * Array of name/value pairs. + * + * @return array + * Array of name/value pairs with casted data types. + */ +function _googleanalytics_convert_form_value_data_types($values) { + + foreach ($values as $name => $value) { + // Convert data types. + // @todo: #2251377: Json utility class serializes boolean values to incorrect data type + $match = drupal_strtolower($value); + if ($match == 'true') { + $value = TRUE; + } + elseif ($match == 'false') { + $value = FALSE; + } + + // Convert other known fields. + // @todo: #2251343: Json utility class serializes numeric values to incorrect data type + switch ($name) { + case 'sampleRate': + // Float + settype($value, 'float'); + break; + + case 'siteSpeedSampleRate': + case 'cookieExpires': + // Integer + settype($value, 'integer'); + break; + } + + $values[$name] = $value; + } + + return $values; +} diff --git a/googleanalytics.admin.js b/googleanalytics.admin.js new file mode 100644 index 0000000..c81470d --- /dev/null +++ b/googleanalytics.admin.js @@ -0,0 +1,140 @@ +(function ($) { + +/** + * Provide the summary information for the tracking settings vertical tabs. + */ +Drupal.behaviors.trackingSettingsSummary = { + attach: function (context) { + // Make sure this behavior is processed only if drupalSetSummary is defined. + if (typeof jQuery.fn.drupalSetSummary == 'undefined') { + return; + } + + $('fieldset#edit-page-vis-settings', context).drupalSetSummary(function (context) { + var $radio = $('input[name="googleanalytics_visibility_pages"]:checked', context); + if ($radio.val() == 0) { + if (!$('textarea[name="googleanalytics_pages"]', context).val()) { + return Drupal.t('Not restricted'); + } + else { + return Drupal.t('All pages with exceptions'); + } + } + else { + return Drupal.t('Restricted to certain pages'); + } + }); + + $('fieldset#edit-role-vis-settings', context).drupalSetSummary(function (context) { + var vals = []; + $('input[type="checkbox"]:checked', context).each(function () { + vals.push($.trim($(this).next('label').text())); + }); + if (!vals.length) { + return Drupal.t('Not restricted'); + } + else if ($('input[name="googleanalytics_visibility_roles"]:checked', context).val() == 1) { + return Drupal.t('Excepted: @roles', {'@roles' : vals.join(', ')}); + } + else { + return vals.join(', '); + } + }); + + $('fieldset#edit-user-vis-settings', context).drupalSetSummary(function (context) { + var $radio = $('input[name="googleanalytics_custom"]:checked', context); + if ($radio.val() == 0) { + return Drupal.t('Not customizable'); + } + else if ($radio.val() == 1) { + return Drupal.t('On by default with opt out'); + } + else { + return Drupal.t('Off by default with opt in'); + } + }); + + $('fieldset#edit-linktracking', context).drupalSetSummary(function (context) { + var vals = []; + if ($('input#edit-googleanalytics-trackoutbound', context).is(':checked')) { + vals.push(Drupal.t('Outbound links')); + } + if ($('input#edit-googleanalytics-trackmailto', context).is(':checked')) { + vals.push(Drupal.t('Mailto links')); + } + if ($('input#edit-googleanalytics-trackfiles', context).is(':checked')) { + vals.push(Drupal.t('Downloads')); + } + if ($('input#edit-googleanalytics-trackcolorbox', context).is(':checked')) { + vals.push(Drupal.t('Colorbox')); + } + if ($('input#edit-googleanalytics-tracklinkid', context).is(':checked')) { + vals.push(Drupal.t('Link attribution')); + } + if ($('input#edit-googleanalytics-trackurlfragments', context).is(':checked')) { + vals.push(Drupal.t('URL fragments')); + } + if (!vals.length) { + return Drupal.t('Not tracked'); + } + return Drupal.t('@items enabled', {'@items' : vals.join(', ')}); + }); + + $('fieldset#edit-messagetracking', context).drupalSetSummary(function (context) { + var vals = []; + $('input[type="checkbox"]:checked', context).each(function () { + vals.push($.trim($(this).next('label').text())); + }); + if (!vals.length) { + return Drupal.t('Not tracked'); + } + return Drupal.t('@items enabled', {'@items' : vals.join(', ')}); + }); + + $('fieldset#edit-search-and-advertising', context).drupalSetSummary(function (context) { + var vals = []; + if ($('input#edit-googleanalytics-site-search', context).is(':checked')) { + vals.push(Drupal.t('Site search')); + } + if ($('input#edit-googleanalytics-trackadsense', context).is(':checked')) { + vals.push(Drupal.t('AdSense ads')); + } + if ($('input#edit-googleanalytics-trackdoubleclick', context).is(':checked')) { + vals.push(Drupal.t('Display features')); + } + if (!vals.length) { + return Drupal.t('Not tracked'); + } + return Drupal.t('@items enabled', {'@items' : vals.join(', ')}); + }); + + $('fieldset#edit-domain-tracking', context).drupalSetSummary(function (context) { + var $radio = $('input[name="googleanalytics_domain_mode"]:checked', context); + if ($radio.val() == 0) { + return Drupal.t('A single domain'); + } + else if ($radio.val() == 1) { + return Drupal.t('One domain with multiple subdomains'); + } + else { + return Drupal.t('Multiple top-level domains'); + } + }); + + $('fieldset#edit-privacy', context).drupalSetSummary(function (context) { + var vals = []; + if ($('input#edit-googleanalytics-tracker-anonymizeip', context).is(':checked')) { + vals.push(Drupal.t('Anonymize IP')); + } + if ($('input#edit-googleanalytics-privacy-donottrack', context).is(':checked')) { + vals.push(Drupal.t('Universal web tracking opt-out')); + } + if (!vals.length) { + return Drupal.t('No privacy'); + } + return Drupal.t('@items enabled', {'@items' : vals.join(', ')}); + }); + } +}; + +})(jQuery); diff --git a/googleanalytics.debug.js b/googleanalytics.debug.js new file mode 100644 index 0000000..7186230 --- /dev/null +++ b/googleanalytics.debug.js @@ -0,0 +1,213 @@ +(function ($) { + +Drupal.googleanalytics = {}; + +$(document).ready(function() { + + // Attach mousedown, keyup, touchstart events to document only and catch + // clicks on all elements. + $(document.body).bind("mousedown keyup touchstart", function(event) { + console.group("Running Google Analytics for Drupal."); + console.info("Event '%s' has been detected.", event.type); + + // Catch the closest surrounding link of a clicked element. + $(event.target).closest("a,area").each(function() { + console.info("Closest element '%o' has been found. URL '%s' extracted.", this, this.href); + + // Is the clicked URL internal? + if (Drupal.googleanalytics.isInternal(this.href)) { + // Skip 'click' tracking, if custom tracking events are bound. + if ($(this).is('.colorbox') && (Drupal.settings.googleanalytics.trackColorbox)) { + // Do nothing here. The custom event will handle all tracking. + console.info("Click on .colorbox item has been detected."); + } + // Is download tracking activated and the file extension configured for download tracking? + else if (Drupal.settings.googleanalytics.trackDownload && Drupal.googleanalytics.isDownload(this.href)) { + // Download link clicked. + console.info("Download url '%s' has been found. Tracked download as extension '%s'.", Drupal.googleanalytics.getPageUrl(this.href), Drupal.googleanalytics.getDownloadExtension(this.href).toUpperCase()); + ga("send", { + "hitType": "event", + "eventCategory": "Downloads", + "eventAction": Drupal.googleanalytics.getDownloadExtension(this.href).toUpperCase(), + "eventLabel": Drupal.googleanalytics.getPageUrl(this.href), + "transport": "beacon" + }); + } + else if (Drupal.googleanalytics.isInternalSpecial(this.href)) { + // Keep the internal URL for Google Analytics website overlay intact. + console.info("Click on internal special link '%s' has been tracked.", Drupal.googleanalytics.getPageUrl(this.href)); + ga("send", { + "hitType": "pageview", + "page": Drupal.googleanalytics.getPageUrl(this.href), + "transport": "beacon" + }); + } + else { + // e.g. anchor in same page or other internal page link + console.info("Click on internal link '%s' detected, but not tracked by click.", this.href); + } + } + else { + if (Drupal.settings.googleanalytics.trackMailto && $(this).is("a[href^='mailto:'],area[href^='mailto:']")) { + // Mailto link clicked. + console.info("Click on e-mail '%s' has been tracked.", this.href.substring(7)); + ga("send", { + "hitType": "event", + "eventCategory": "Mails", + "eventAction": "Click", + "eventLabel": this.href.substring(7), + "transport": "beacon" + }); + } + else if (Drupal.settings.googleanalytics.trackOutbound && this.href.match(/^\w+:\/\//i)) { + if (Drupal.settings.googleanalytics.trackDomainMode !== 2 || (Drupal.settings.googleanalytics.trackDomainMode === 2 && !Drupal.googleanalytics.isCrossDomain(this.hostname, Drupal.settings.googleanalytics.trackCrossDomains))) { + // External link clicked / No top-level cross domain clicked. + console.info("Outbound link '%s' has been tracked.", this.href); + ga("send", { + "hitType": "event", + "eventCategory": "Outbound links", + "eventAction": "Click", + "eventLabel": this.href, + "transport": "beacon" + }); + } + else { + console.info("Internal link '%s' clicked, not tracked.", this.href); + } + } + } + }); + + console.groupEnd(); + }); + + // Track hash changes as unique pageviews, if this option has been enabled. + if (Drupal.settings.googleanalytics.trackUrlFragments) { + window.onhashchange = function() { + console.info("Track URL '%s' as pageview. Hash '%s' has changed.", location.pathname + location.search + location.hash, location.hash); + ga("send", { + "hitType": "pageview", + "page": location.pathname + location.search + location.hash + }); + }; + } + + // Colorbox: This event triggers when the transition has completed and the + // newly loaded content has been revealed. + if (Drupal.settings.googleanalytics.trackColorbox) { + $(document).bind("cbox_complete", function () { + var href = $.colorbox.element().attr("href"); + if (href) { + console.info("Colorbox transition to url '%s' has been tracked.", Drupal.googleanalytics.getPageUrl(href)); + ga("send", { + "hitType": "pageview", + "page": Drupal.googleanalytics.getPageUrl(href) + }); + } + }); + } + +}); + +/** + * Check whether the hostname is part of the cross domains or not. + * + * @param string hostname + * The hostname of the clicked URL. + * @param array crossDomains + * All cross domain hostnames as JS array. + * + * @return boolean + */ +Drupal.googleanalytics.isCrossDomain = function (hostname, crossDomains) { + /** + * jQuery < 1.6.3 bug: $.inArray crushes IE6 and Chrome if second argument is + * `null` or `undefined`, https://bugs.jquery.com/ticket/10076, + * https://github.com/jquery/jquery/commit/a839af034db2bd934e4d4fa6758a3fed8de74174 + * + * @todo: Remove/Refactor in D8 + */ + if (!crossDomains) { + return false; + } + else { + return $.inArray(hostname, crossDomains) > -1 ? true : false; + } +}; + +/** + * Check whether this is a download URL or not. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isDownload = function (url) { + var isDownload = new RegExp("\\.(" + Drupal.settings.googleanalytics.trackDownloadExtensions + ")([\?#].*)?$", "i"); + return isDownload.test(url); +}; + +/** + * Check whether this is an absolute internal URL or not. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isInternal = function (url) { + var isInternal = new RegExp("^(https?):\/\/" + window.location.host, "i"); + return isInternal.test(url); +}; + +/** + * Check whether this is a special URL or not. + * + * URL types: + * - gotwo.module /go/* links. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isInternalSpecial = function (url) { + var isInternalSpecial = new RegExp("(\/go\/.*)$", "i"); + return isInternalSpecial.test(url); +}; + +/** + * Extract the relative internal URL from an absolute internal URL. + * + * Examples: + * - https://mydomain.com/node/1 -> /node/1 + * - https://example.com/foo/bar -> https://example.com/foo/bar + * + * @param string url + * The web url to check. + * + * @return string + * Internal website URL + */ +Drupal.googleanalytics.getPageUrl = function (url) { + var extractInternalUrl = new RegExp("^(https?):\/\/" + window.location.host, "i"); + return url.replace(extractInternalUrl, ''); +}; + +/** + * Extract the download file extension from the URL. + * + * @param string url + * The web url to check. + * + * @return string + * The file extension of the passed url. e.g. "zip", "txt" + */ +Drupal.googleanalytics.getDownloadExtension = function (url) { + var extractDownloadextension = new RegExp("\\.(" + Drupal.settings.googleanalytics.trackDownloadExtensions + ")([\?#].*)?$", "i"); + var extension = extractDownloadextension.exec(url); + return (extension === null) ? '' : extension[1]; +}; + +})(jQuery); diff --git a/googleanalytics.info b/googleanalytics.info new file mode 100644 index 0000000..591816a --- /dev/null +++ b/googleanalytics.info @@ -0,0 +1,12 @@ +name = Google Analytics +description = Allows your site to be tracked by Google Analytics by adding a Javascript tracking code to every page. +core = 7.x +package = Statistics +configure = admin/config/system/googleanalytics +files[] = googleanalytics.test +test_dependencies[] = token +; Information added by Drupal.org packaging script on 2019-01-31 +version = "7.x-2.6" +core = "7.x" +project = "google_analytics" +datestamp = "1548968597" diff --git a/googleanalytics.install b/googleanalytics.install new file mode 100644 index 0000000..08b4e05 --- /dev/null +++ b/googleanalytics.install @@ -0,0 +1,548 @@ + $t('Google Analytics module'), + 'description' => $t('Google Analytics module has not been configured yet. Please configure its settings from the Google Analytics settings page.', array('@url' => url('admin/config/system/googleanalytics'))), + 'severity' => REQUIREMENT_WARNING, + 'value' => $t('Not configured'), + ); + } + + // Raise warning if debugging is enabled. + if (variable_get('googleanalytics_debug', 0)) { + $requirements['google_analytics_debugging'] = array( + 'title' => $t('Google Analytics module'), + 'description' => $t('Google Analytics module has debugging enabled. Please disable debugging setting in production sites from the Google Analytics settings page.', array('@url' => url('admin/config/system/googleanalytics'))), + 'severity' => REQUIREMENT_WARNING, + 'value' => $t('Debugging enabled'), + ); + } + } + + return $requirements; +} + +/** + * Upgrade old extension variable to new and use old name as enabled/disabled + * flag. + */ +function googleanalytics_update_6000() { + variable_set('googleanalytics_trackfiles_extensions', variable_get('googleanalytics_trackfiles', '7z|aac|avi|csv|doc|exe|flv|gif|gz|jpe?g|js|mp(3|4|e?g)|mov|pdf|phps|png|ppt|rar|sit|tar|torrent|txt|wma|wmv|xls|xml|zip')); + $trackfiles = variable_get('googleanalytics_trackfiles', '7z|aac|avi|csv|doc|exe|flv|gif|gz|jpe?g|js|mp(3|4|e?g)|mov|pdf|phps|png|ppt|rar|sit|tar|torrent|txt|wma|wmv|xls|xml|zip') ? TRUE : FALSE; + variable_set('googleanalytics_trackfiles', $trackfiles); + + return t('Updated download tracking file extensions.'); +} + +function googleanalytics_update_6001() { + variable_set('googleanalytics_visibility', 0); + + // Remove tracking from all administrative pages, see: + // https://drupal.org/node/34970. + $pages = array( + 'admin*', + 'user*', + 'node/add*', + 'node/*/*', + ); + variable_set('googleanalytics_pages', implode("\n", $pages)); + + return t('Added page tracking to every page except the listed pages: @pages.', array('@pages' => implode(', ', $pages))); +} + +/** + * Upgrade role settings and per user tracking settings of "User 1" and remove + * outdated tracking variables. + */ +function googleanalytics_update_6002() { + // Upgrade enabled/disabled roles to new logic (correct for upgrades from + // 5.x-1.4 and 6.x-1.0). + $roles = array(); + $messages = array(); + foreach (user_roles() as $rid => $name) { + if (variable_get('googleanalytics_track_' . $rid, FALSE)) { + // Role ID is activated for user tracking. + $roles[$rid] = $rid; + $messages[] = t('Enabled page tracking for role: @name.', array('@name' => $name)); + } + else { + $messages[] = t('Disabled page tracking for role: @name.', array('@name' => $name)); + } + } + variable_set('googleanalytics_roles', $roles); + + // Upgrade disabled tracking of "user 1" to new logic. + if (!$track_user1 = variable_get('googleanalytics_track__user1', 1)) { + variable_set('googleanalytics_custom', 1); + + // Load user 1 object, set appropriate value and save new user settings. + $account = user_load(1); + $account = user_save($account, array('data' => array('googleanalytics' => array('custom' => 0))), 'account'); + $messages[] = t('Disabled user specific page tracking for site administrator.'); + } + + // Delete outdated tracking settings. + db_delete('variable') + ->condition('name', db_like('googleanalytics_track_') . '%', 'LIKE') + ->execute(); + + return implode(', ', $messages); +} + +/** + * #262468: Clear menu cache to solve stale menu data in 5.x-1.5 and 6.x-1.1. + */ +function googleanalytics_update_6003() { + menu_rebuild(); + return t('Menu has been rebuilt.'); +} + +/** + * Change visibility setting for path "user/*". + */ +function googleanalytics_update_6004() { + // Original pages setting. + $pages = array( + 'admin*', + 'user*', + 'node/add*', + 'node/*/*', + ); + + $diff = array_diff($pages, preg_split('/(\r\n?|\n)/', variable_get('googleanalytics_pages', implode("\n", $pages)))); + if (empty($diff)) { + // No diff to original settings found. Update with new settings. + $pages = array( + 'admin*', + 'user/*/*', + 'node/add*', + 'node/*/*', + ); + variable_set('googleanalytics_pages', implode("\n", $pages)); + return t('Path visibility filter setting changed from "user*" to "user/*/*".'); + } + else { + return t('Custom path visibility filter setting found. Update skipped!'); + } +} + +/** + * Change visibility setting for path "admin*". + */ +function googleanalytics_update_6005() { + // Original pages setting. + $pages = array( + 'admin*', + 'user/*/*', + 'node/add*', + 'node/*/*', + ); + + $diff = array_diff($pages, preg_split('/(\r\n?|\n)/', variable_get('googleanalytics_pages', implode("\n", $pages)))); + if (empty($diff)) { + // No diff to original settings found. Update with new settings. + $pages = array( + 'admin', + 'admin/*', + 'user/*/*', + 'node/add*', + 'node/*/*', + ); + variable_set('googleanalytics_pages', implode("\n", $pages)); + return t('Path visibility filter setting changed from "admin*" to "admin" and "admin/*".'); + } + else { + return t('Custom path visibility filter setting found. Update skipped!'); + } +} + +/** + * Upgrade custom javascript settings. + */ +function googleanalytics_update_6006() { + variable_set('googleanalytics_codesnippet_before', variable_get('googleanalytics_codesnippet', '')); + variable_del('googleanalytics_codesnippet'); + + return t('Upgraded custom javascript codesnippet setting.'); +} + +/** + * Remove "User identifier" and "User name" from segmentation fields. + * + * This is a data protection and privacy law change. For more information see + * Google Analytics terms of use section 8.1: + * https://www.google.com/analytics/en-GB/tos.html + */ +function googleanalytics_update_6007() { + $profile_fields = variable_get('googleanalytics_segmentation', array()); + unset($profile_fields['uid']); + unset($profile_fields['name']); + variable_set('googleanalytics_segmentation', $profile_fields); + + return t('Removed "User identifier" and "User name" from segmentation fields.'); +} + +/** + * Remove outdated legacy support variables and files. + */ +function googleanalytics_update_6200() { + $path = 'public://googleanalytics'; + if (file_exists($path)) { + file_unmanaged_delete($path . '/urchin.js'); + } + variable_del('googleanalytics_legacy_version'); + + return t('Removed outdated legacy tracker stuff.'); +} + +/** + * Update list of default file extensions. + */ +function googleanalytics_update_6201() { + if (variable_get('googleanalytics_trackfiles_extensions', '') == '7z|aac|avi|csv|doc|exe|flv|gif|gz|jpe?g|js|mp(3|4|e?g)|mov|pdf|phps|png|ppt|rar|sit|tar|torrent|txt|wma|wmv|xls|xml|zip') { + variable_set('googleanalytics_trackfiles_extensions', '7z|aac|arc|arj|asf|asx|avi|bin|csv|doc|exe|flv|gif|gz|gzip|hqx|jar|jpe?g|js|mp(2|3|4|e?g)|mov(ie)?|msi|msp|pdf|phps|png|ppt|qtm?|ra(m|r)?|sea|sit|tar|tgz|torrent|txt|wav|wma|wmv|wpd|xls|xml|z|zip'); + } + + return t('The default extensions for download tracking have been updated.'); +} + +/** + * Try to update Google Analytics custom code snippet to async version. + */ +function googleanalytics_update_6300() { + $messages = array(); + + // TODO: Backup synchronous code snippets. Remove variables in D8. + variable_set('googleanalytics_codesnippet_before_backup_6300', variable_get('googleanalytics_codesnippet_before', '')); + variable_set('googleanalytics_codesnippet_after_backup_6300', variable_get('googleanalytics_codesnippet_after', '')); + + // Upgrade of BEFORE code snippet. + $code_before = variable_get('googleanalytics_codesnippet_before', ''); + if (!empty($code_before)) { + // No value, e.g. _setLocalRemoteServerMode() + $code_before = preg_replace('/(.*)pageTracker\.(\w+)\(\);(.*)/i', '$1_gaq.push(["$2"]);$3', $code_before); + // One value, e.g. _setCookiePath() + $code_before = preg_replace('/(.*)pageTracker\.(\w+)\(("|\'?)(\w+)("|\'?)\);(.*)/i', '$1_gaq.push(["$2", $3$4$5]);$6', $code_before); + // Multiple values e.g. _trackEvent() + $code_before = preg_replace('/(.*)pageTracker\.(\w+)\((.*)\);(.*)/i', '$1_gaq.push(["$2", $3]);$4', $code_before); + + variable_set('googleanalytics_codesnippet_before', $code_before); + + drupal_set_message(Database::getConnection()->prefixTables("Attempted to upgrade Google Analytics custom 'before' code snippet. Backup of previous code snippet has been saved in database table '{variable}' as 'googleanalytics_codesnippet_before_backup_6300'. Please consult Google's Asynchronous Tracking Usage Guide if the upgrade was successfully."), 'warning'); + $messages[] = t('Upgraded custom "before" code snippet.'); + } + + // Upgrade of AFTER code snippet. We cannot update this code snippet + // automatically. Show message that the upgrade has been skipped. + $code_after = variable_get('googleanalytics_codesnippet_after', ''); + if (!empty($code_after)) { + drupal_set_message(Database::getConnection()->prefixTables("Automatic upgrade of Google Analytics custom 'after' code snippet has been skipped. Backup of previous code snippet has been saved in database table '{variable}' as 'googleanalytics_codesnippet_after_backup_6300'. You need to manually upgrade the custom 'after' code snippet."), 'error'); + $messages[] = t('Skipped custom "after" code snippet.'); + } + + return empty($messages) ? t('No custom code snippet found. Nothing to do.') : implode(' ', $messages); +} + +/** + * Run D6 -> D7 upgrades. + */ +function googleanalytics_update_7000() { + // Update JavaScript scope to 'header'. + variable_set('googleanalytics_js_scope', 'header'); + $messages[] = t('Google tracking code has been moved to header.'); + + // Upgrade D6 token placeholder to D7. update_6301 is not required. + $googleanalytics_custom_vars = variable_get('googleanalytics_custom_var', array()); + if (!empty($googleanalytics_custom_vars['slots'][1]) && $googleanalytics_custom_vars['slots'][1]['name'] == 'User roles' && $googleanalytics_custom_vars['slots'][1]['value'] = '[user-role-names]') { + $googleanalytics_custom_vars['slots'][1]['value'] = '[current-user:role-names]'; + variable_set('googleanalytics_custom_var', $googleanalytics_custom_vars); + $messages[] = t("The D6 token placeholder [user-role-names] used in the custom variable 'User roles' has been replaced with [current-user:role-names]."); + } + + return implode(' ', $messages); +} + +/** + * Automatically enable anonymizing of IP addresses for Germany. + */ +function googleanalytics_update_7001() { + // By German law it's always best to enable the anonymizing of IP addresses. + $countries = array( + 'DE', + ); + if (in_array(variable_get('site_default_country', ''), $countries)) { + variable_set('googleanalytics_tracker_anonymizeip', 1); + return t('The default country in your regional settings is Germany. Anonymizing of IP addresses has been enabled for privacy reasons.'); + } + else { + return t('The default country in your regional settings is not Germany. The anonymizing of IP addresses setting has not been changed. Make sure your site settings comply with the local privacy rules.'); + } +} + +/** + * Upgrade "User roles" tracking to custom variables. + */ +function googleanalytics_update_7002() { + + // Read previous segmentation settings. + $segmentation = variable_get('googleanalytics_segmentation', array()); + + // If this is an upgrade from D6 the slot 1 may not empty. + if (empty($googleanalytics_custom_vars['slots'][1]) && in_array('roles', $segmentation)) { + // Upgrade previous segmentation settings to new custom variables settings. + $googleanalytics_custom_vars = variable_get('googleanalytics_custom_var', array()); + + $googleanalytics_custom_vars['slots'][1]['slot'] = 1; + $googleanalytics_custom_vars['slots'][1]['name'] = 'User roles'; + $googleanalytics_custom_vars['slots'][1]['value'] = '[current-user:role-names]'; + // Sets the scope to visitor-level. + $googleanalytics_custom_vars['slots'][1]['scope'] = 1; + + variable_set('googleanalytics_custom_var', $googleanalytics_custom_vars); + return t('The deprecated profile segmentation setting for "User roles" has been added to custom variables. You need to deselect all selected profile fields in Google Analytics settings and upgrade other profile fields manually or you may lose tracking data in future! See Google Analytics Custom Variables for more information.', array('@customvar' => 'https://developers.google.com/analytics/devguides/collection/gajs/gaTrackingCustomVariables', '@admin' => url('admin/config/system/googleanalytics'))); + } + else { + return t('You need to deselect all selected profile fields in Google Analytics settings and upgrade other profile fields manually or you may lose tracking data in future! See Google Analytics Custom Variables for more information.', array('@customvar' => 'https://developers.google.com/analytics/devguides/collection/gajs/gaTrackingCustomVariables', '@admin' => url('admin/config/system/googleanalytics'))); + } +} + +/** + * Rename googleanalytics_trackoutgoing variable to + * googleanalytics_trackoutbound. + */ +function googleanalytics_update_7003() { + variable_set('googleanalytics_trackoutbound', variable_get('googleanalytics_trackoutgoing', 1)); + variable_del('googleanalytics_trackoutgoing'); + + return t('Renamed "googleanalytics_trackoutgoing" settings variable to googleanalytics_trackoutbound.'); +} + +/** + * Rename googleanalytics_visibility variable to + * googleanalytics_visibility_pages for consistency. + */ +function googleanalytics_update_7004() { + variable_set('googleanalytics_visibility_pages', variable_get('googleanalytics_visibility', 1)); + variable_del('googleanalytics_visibility'); + + return t('Renamed "googleanalytics_visibility" settings variable to googleanalytics_visibility_pages.'); +} + +/** + * Path visibility filter setting should hide "batch" path. + */ +function googleanalytics_update_7005() { + // Current pages setting. + $pages = array( + 'admin', + 'admin/*', + 'user/*/*', + 'node/add*', + 'node/*/*', + ); + + $diff = array_diff($pages, preg_split('/(\r\n?|\n)/', variable_get('googleanalytics_pages', implode("\n", $pages)))); + if (empty($diff)) { + // No difference to previous settings found. Update with new settings. + $pages = array( + 'admin', + 'admin/*', + 'batch', + 'node/add*', + 'node/*/*', + 'user/*/*', + ); + variable_set('googleanalytics_pages', implode("\n", $pages)); + return t('Added "batch" to path visibility filter setting.'); + } + else { + return t('Custom path visibility filter setting found. Update skipped!'); + } +} + +/** + * Delete obsolete trackOutboundAsPageview variable. + */ +function googleanalytics_update_7006() { + variable_del('googleanalytics_trackoutboundaspageview'); + + return t('Deleted obsolete trackOutboundAsPageview variable.'); +} + +/** + * Delete obsolete googleanalytics_trackpageloadtime variable. + */ +function googleanalytics_update_7007() { + variable_del('googleanalytics_trackpageloadtime'); + + return t('Deleted obsolete googleanalytics_trackpageloadtime variable.'); +} + +/** + * Delete custom ga.js code snippets to prevent malfunctions in new Universal + * Analytics tracker. A backup of your snippets will be created. + */ +function googleanalytics_update_7200() { + $messages = array(); + + // ga.js code will cause the tracker to break. Remove custom code snippets. + $googleanalytics_codesnippet_before = variable_get('googleanalytics_codesnippet_before', ''); + if (!empty($googleanalytics_codesnippet_before) && stristr($googleanalytics_codesnippet_before, '_gaq.push(')) { + variable_set('googleanalytics_codesnippet_before_backup_7200', $googleanalytics_codesnippet_before); + variable_del('googleanalytics_codesnippet_before'); + drupal_set_message(Database::getConnection()->prefixTables("A backup of your previous Google Analytics code snippet (ga.js) has been saved in database table '{variable}' as 'googleanalytics_codesnippet_before_backup_7200'. You need to manually upgrade the custom 'before' code snippet to analytics.js API."), 'warning'); + $messages[] = t('Manual upgrade of custom "before" code snippet from ja.js to analytics.js API is required.'); + } + + $googleanalytics_codesnippet_after = variable_get('googleanalytics_codesnippet_after', ''); + if (!empty($googleanalytics_codesnippet_after) && stristr($googleanalytics_codesnippet_after, '_gaq.push(')) { + variable_set('googleanalytics_codesnippet_after_backup_7200', $googleanalytics_codesnippet_after); + variable_del('googleanalytics_codesnippet_after'); + drupal_set_message(Database::getConnection()->prefixTables("A backup of your previous Google Analytics code snippet (ga.js) has been saved in database table '{variable}' as 'googleanalytics_codesnippet_after_backup_7200'. You need to manually upgrade the custom 'after' code snippet to analytics.js API."), 'warning'); + $messages[] = t('Manual upgrade of custom "after" code snippet from ja.js to analytics.js API is required.'); + } + + return empty($messages) ? t('No custom code snippet found. Nothing to do.') : implode(' ', $messages); +} + +/** + * Delete obsolete custom variables. Custom variables are now custom dimensions + * and metrics. + */ +function googleanalytics_update_7201() { + variable_del('googleanalytics_custom_var'); + + return t('Deleted obsolete custom variables. Custom variables are now custom dimensions and metrics and you need to manually configure them!'); +} + +/** + * Delete obsolete JavaScript scope variable. + */ +function googleanalytics_update_7202() { + // Remove obsolete scope variable. + variable_del('googleanalytics_js_scope'); + + return t('Removed obsolete JavaScript scope variable.'); +} + +/** + * Flatten the metrics and dimensions arrays. + */ +function googleanalytics_update_7203() { + $googleanalytics_custom_dimension = variable_get('googleanalytics_custom_dimension', array()); + if (isset($googleanalytics_custom_dimension['indexes'])) { + foreach ($googleanalytics_custom_dimension['indexes'] as $dimension) { + $googleanalytics_custom_dimension['indexes'][$dimension['index']]['value'] = trim($dimension['value']); + // Remove empty values from the array. + if (!drupal_strlen($googleanalytics_custom_dimension['indexes'][$dimension['index']]['value'])) { + unset($googleanalytics_custom_dimension['indexes'][$dimension['index']]); + } + } + variable_set('googleanalytics_custom_dimension', $googleanalytics_custom_dimension['indexes']); + } + $googleanalytics_custom_metric = variable_get('googleanalytics_custom_metric', array()); + if (isset($googleanalytics_custom_metric['indexes'])) { + foreach ($googleanalytics_custom_metric['indexes'] as $dimension) { + $googleanalytics_custom_metric['indexes'][$dimension['index']]['value'] = trim($dimension['value']); + // Remove empty values from the array. + if (!drupal_strlen($googleanalytics_custom_metric['indexes'][$dimension['index']]['value'])) { + unset($googleanalytics_custom_metric['indexes'][$dimension['index']]); + } + } + variable_set('googleanalytics_custom_metric', $googleanalytics_custom_metric['indexes']); + } + + return t('Saved custom dimensions and metrics.'); +} + +/** + * Remove obsolete backup variables. + */ +function googleanalytics_update_7204() { + variable_del('googleanalytics_segmentation'); + variable_del('googleanalytics_codesnippet_after_backup_6300'); + variable_del('googleanalytics_codesnippet_before_backup_6300'); + variable_del('googleanalytics_codesnippet_after_backup_6400'); + variable_del('googleanalytics_codesnippet_before_backup_6400'); + + return t('Removed obsolete backup variables.'); +} + +/** + * Update list of default file extensions. + */ +function googleanalytics_update_7205() { + if (variable_get('googleanalytics_trackfiles_extensions', '') == '7z|aac|arc|arj|asf|asx|avi|bin|csv|doc|exe|flv|gif|gz|gzip|hqx|jar|jpe?g|js|mp(2|3|4|e?g)|mov(ie)?|msi|msp|pdf|phps|png|ppt|qtm?|ra(m|r)?|sea|sit|tar|tgz|torrent|txt|wav|wma|wmv|wpd|xls|xml|z|zip') { + variable_set('googleanalytics_trackfiles_extensions', '7z|aac|arc|arj|asf|asx|avi|bin|csv|doc(x|m)?|dot(x|m)?|exe|flv|gif|gz|gzip|hqx|jar|jpe?g|js|mp(2|3|4|e?g)|mov(ie)?|msi|msp|pdf|phps|png|ppt(x|m)?|pot(x|m)?|pps(x|m)?|ppam|sld(x|m)?|thmx|qtm?|ra(m|r)?|sea|sit|tar|tgz|torrent|txt|wav|wma|wmv|wpd|xls(x|m|b)?|xlt(x|m)|xlam|xml|z|zip'); + return t('The default extensions for download tracking have been updated.'); + } + else { + return t('Custom extensions for download tracking setting found. Update skipped!'); + } +} diff --git a/googleanalytics.js b/googleanalytics.js new file mode 100644 index 0000000..5ba42ca --- /dev/null +++ b/googleanalytics.js @@ -0,0 +1,195 @@ +(function ($) { + +Drupal.googleanalytics = {}; + +$(document).ready(function() { + + // Attach mousedown, keyup, touchstart events to document only and catch + // clicks on all elements. + $(document.body).bind("mousedown keyup touchstart", function(event) { + + // Catch the closest surrounding link of a clicked element. + $(event.target).closest("a,area").each(function() { + + // Is the clicked URL internal? + if (Drupal.googleanalytics.isInternal(this.href)) { + // Skip 'click' tracking, if custom tracking events are bound. + if ($(this).is('.colorbox') && (Drupal.settings.googleanalytics.trackColorbox)) { + // Do nothing here. The custom event will handle all tracking. + //console.info("Click on .colorbox item has been detected."); + } + // Is download tracking activated and the file extension configured for download tracking? + else if (Drupal.settings.googleanalytics.trackDownload && Drupal.googleanalytics.isDownload(this.href)) { + // Download link clicked. + ga("send", { + "hitType": "event", + "eventCategory": "Downloads", + "eventAction": Drupal.googleanalytics.getDownloadExtension(this.href).toUpperCase(), + "eventLabel": Drupal.googleanalytics.getPageUrl(this.href), + "transport": "beacon" + }); + } + else if (Drupal.googleanalytics.isInternalSpecial(this.href)) { + // Keep the internal URL for Google Analytics website overlay intact. + ga("send", { + "hitType": "pageview", + "page": Drupal.googleanalytics.getPageUrl(this.href), + "transport": "beacon" + }); + } + } + else { + if (Drupal.settings.googleanalytics.trackMailto && $(this).is("a[href^='mailto:'],area[href^='mailto:']")) { + // Mailto link clicked. + ga("send", { + "hitType": "event", + "eventCategory": "Mails", + "eventAction": "Click", + "eventLabel": this.href.substring(7), + "transport": "beacon" + }); + } + else if (Drupal.settings.googleanalytics.trackOutbound && this.href.match(/^\w+:\/\//i)) { + if (Drupal.settings.googleanalytics.trackDomainMode !== 2 || (Drupal.settings.googleanalytics.trackDomainMode === 2 && !Drupal.googleanalytics.isCrossDomain(this.hostname, Drupal.settings.googleanalytics.trackCrossDomains))) { + // External link clicked / No top-level cross domain clicked. + ga("send", { + "hitType": "event", + "eventCategory": "Outbound links", + "eventAction": "Click", + "eventLabel": this.href, + "transport": "beacon" + }); + } + } + } + }); + }); + + // Track hash changes as unique pageviews, if this option has been enabled. + if (Drupal.settings.googleanalytics.trackUrlFragments) { + window.onhashchange = function() { + ga("send", { + "hitType": "pageview", + "page": location.pathname + location.search + location.hash + }); + }; + } + + // Colorbox: This event triggers when the transition has completed and the + // newly loaded content has been revealed. + if (Drupal.settings.googleanalytics.trackColorbox) { + $(document).bind("cbox_complete", function () { + var href = $.colorbox.element().attr("href"); + if (href) { + ga("send", { + "hitType": "pageview", + "page": Drupal.googleanalytics.getPageUrl(href) + }); + } + }); + } + +}); + +/** + * Check whether the hostname is part of the cross domains or not. + * + * @param string hostname + * The hostname of the clicked URL. + * @param array crossDomains + * All cross domain hostnames as JS array. + * + * @return boolean + */ +Drupal.googleanalytics.isCrossDomain = function (hostname, crossDomains) { + /** + * jQuery < 1.6.3 bug: $.inArray crushes IE6 and Chrome if second argument is + * `null` or `undefined`, https://bugs.jquery.com/ticket/10076, + * https://github.com/jquery/jquery/commit/a839af034db2bd934e4d4fa6758a3fed8de74174 + * + * @todo: Remove/Refactor in D8 + */ + if (!crossDomains) { + return false; + } + else { + return $.inArray(hostname, crossDomains) > -1 ? true : false; + } +}; + +/** + * Check whether this is a download URL or not. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isDownload = function (url) { + var isDownload = new RegExp("\\.(" + Drupal.settings.googleanalytics.trackDownloadExtensions + ")([\?#].*)?$", "i"); + return isDownload.test(url); +}; + +/** + * Check whether this is an absolute internal URL or not. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isInternal = function (url) { + var isInternal = new RegExp("^(https?):\/\/" + window.location.host, "i"); + return isInternal.test(url); +}; + +/** + * Check whether this is a special URL or not. + * + * URL types: + * - gotwo.module /go/* links. + * + * @param string url + * The web url to check. + * + * @return boolean + */ +Drupal.googleanalytics.isInternalSpecial = function (url) { + var isInternalSpecial = new RegExp("(\/go\/.*)$", "i"); + return isInternalSpecial.test(url); +}; + +/** + * Extract the relative internal URL from an absolute internal URL. + * + * Examples: + * - https://mydomain.com/node/1 -> /node/1 + * - https://example.com/foo/bar -> https://example.com/foo/bar + * + * @param string url + * The web url to check. + * + * @return string + * Internal website URL + */ +Drupal.googleanalytics.getPageUrl = function (url) { + var extractInternalUrl = new RegExp("^(https?):\/\/" + window.location.host, "i"); + return url.replace(extractInternalUrl, ''); +}; + +/** + * Extract the download file extension from the URL. + * + * @param string url + * The web url to check. + * + * @return string + * The file extension of the passed url. e.g. "zip", "txt" + */ +Drupal.googleanalytics.getDownloadExtension = function (url) { + var extractDownloadextension = new RegExp("\\.(" + Drupal.settings.googleanalytics.trackDownloadExtensions + ")([\?#].*)?$", "i"); + var extension = extractDownloadextension.exec(url); + return (extension === null) ? '' : extension[1]; +}; + +})(jQuery); diff --git a/googleanalytics.module b/googleanalytics.module new file mode 100644 index 0000000..0026703 --- /dev/null +++ b/googleanalytics.module @@ -0,0 +1,711 @@ + + */ + +/** + * Define the default file extension list that should be tracked as download. + */ +define('GOOGLEANALYTICS_TRACKFILES_EXTENSIONS', '7z|aac|arc|arj|asf|asx|avi|bin|csv|doc(x|m)?|dot(x|m)?|exe|flv|gif|gz|gzip|hqx|jar|jpe?g|js|mp(2|3|4|e?g)|mov(ie)?|msi|msp|pdf|phps|png|ppt(x|m)?|pot(x|m)?|pps(x|m)?|ppam|sld(x|m)?|thmx|qtm?|ra(m|r)?|sea|sit|tar|tgz|torrent|txt|wav|wma|wmv|wpd|xls(x|m|b)?|xlt(x|m)|xlam|xml|z|zip'); + +/** + * Define default path exclusion list to remove tracking from admin pages, + * see https://drupal.org/node/34970 for more information. + */ +define('GOOGLEANALYTICS_PAGES', "admin\nadmin/*\nbatch\nnode/add*\nnode/*/*\nuser/*/*"); + +/** + * Advertise the supported google analytics api details. + */ +function googleanalytics_api() { + return array( + 'api' => 'analytics.js', + ); +} + +/** + * Implements hook_help(). + */ +function googleanalytics_help($path, $arg) { + switch ($path) { + case 'admin/config/system/googleanalytics': + return t('Google Analytics is a free (registration required) website traffic and marketing effectiveness service.', array('@ga_url' => 'https://marketingplatform.google.com/about/analytics/')); + } +} + +/** + * Implements hook_theme(). + */ +function googleanalytics_theme() { + return array( + 'googleanalytics_admin_custom_var_table' => array( + 'render element' => 'form', + ), + ); +} + +/** + * Implements hook_permission(). + */ +function googleanalytics_permission() { + return array( + 'administer google analytics' => array( + 'title' => t('Administer Google Analytics'), + 'description' => t('Perform maintenance tasks for Google Analytics.'), + ), + 'opt-in or out of tracking' => array( + 'title' => t('Opt-in or out of tracking'), + 'description' => t('Allow users to decide if tracking code will be added to pages or not.'), + ), + 'use PHP for tracking visibility' => array( + 'title' => t('Use PHP for tracking visibility'), + 'description' => t('Enter PHP code in the field for tracking visibility settings.'), + 'restrict access' => TRUE, + ), + 'add JS snippets for google analytics' => array( + 'title' => t('Add JavaScript snippets'), + 'description' => 'Enter JavaScript code snippets for advanced Google Analytics functionality.', + 'restrict access' => TRUE, + ), + ); +} + +/** + * Implements hook_menu(). + */ +function googleanalytics_menu() { + $items['admin/config/system/googleanalytics'] = array( + 'title' => 'Google Analytics', + 'description' => 'Configure tracking behavior to get insights into your website traffic and marketing effectiveness.', + 'page callback' => 'drupal_get_form', + 'page arguments' => array('googleanalytics_admin_settings_form'), + 'access arguments' => array('administer google analytics'), + 'type' => MENU_NORMAL_ITEM, + 'file' => 'googleanalytics.admin.inc', + ); + + return $items; +} + +/** + * Implements hook_page_alter() to insert JavaScript to the appropriate scope/region of the page. + */ +function googleanalytics_page_alter(&$page) { + global $base_path, $user; + + $id = variable_get('googleanalytics_account', ''); + + // Get page status code for visibility filtering. + $status = drupal_get_http_header('Status'); + $trackable_status_codes = array( + '403 Forbidden', + '404 Not Found', + ); + + // 1. Check if the GA account number has a valid value. + // 2. Track page views based on visibility value. + // 3. Check if we should track the currently active user's role. + // 4. Ignore pages visibility filter for 404 or 403 status codes. + if (preg_match('/^UA-\d+-\d+$/', $id) && (_googleanalytics_visibility_pages() || in_array($status, $trackable_status_codes)) && _googleanalytics_visibility_user($user)) { + + $debug = variable_get('googleanalytics_debug', 0); + $url_custom = ''; + + // Add link tracking. + $link_settings = array(); + if ($track_outbound = variable_get('googleanalytics_trackoutbound', 1)) { + $link_settings['trackOutbound'] = $track_outbound; + } + if ($track_mailto = variable_get('googleanalytics_trackmailto', 1)) { + $link_settings['trackMailto'] = $track_mailto; + } + if (($track_download = variable_get('googleanalytics_trackfiles', 1)) && ($trackfiles_extensions = variable_get('googleanalytics_trackfiles_extensions', GOOGLEANALYTICS_TRACKFILES_EXTENSIONS))) { + $link_settings['trackDownload'] = $track_download; + $link_settings['trackDownloadExtensions'] = $trackfiles_extensions; + } + if (module_exists('colorbox') && ($track_colorbox = variable_get('googleanalytics_trackcolorbox', 1))) { + $link_settings['trackColorbox'] = $track_colorbox; + } + if ($track_domain_mode = variable_get('googleanalytics_domain_mode', 0)) { + $link_settings['trackDomainMode'] = (int) $track_domain_mode; + } + if ($track_cross_domains = variable_get('googleanalytics_cross_domains', '')) { + $link_settings['trackCrossDomains'] = preg_split('/(\r\n?|\n)/', $track_cross_domains); + } + if ($track_url_fragments = variable_get('googleanalytics_trackurlfragments', 0)) { + $link_settings['trackUrlFragments'] = $track_url_fragments; + $url_custom = 'location.pathname + location.search + location.hash'; + } + + if (!empty($link_settings)) { + drupal_add_js(array('googleanalytics' => $link_settings), 'setting'); + + // Add debugging code. + if ($debug) { + drupal_add_js(drupal_get_path('module', 'googleanalytics') . '/googleanalytics.debug.js'); + // Add the JS test in development to the page. + //drupal_add_js(drupal_get_path('module', 'googleanalytics') . '/googleanalytics.test.js'); + } + else { + drupal_add_js(drupal_get_path('module', 'googleanalytics') . '/googleanalytics.js'); + } + } + + // Add messages tracking. + $message_events = ''; + if ($message_types = variable_get('googleanalytics_trackmessages', array())) { + $message_types = array_values(array_filter($message_types)); + $status_heading = array( + 'status' => t('Status message'), + 'warning' => t('Warning message'), + 'error' => t('Error message'), + ); + + foreach (drupal_get_messages(NULL, FALSE) as $type => $messages) { + // Track only the selected message types. + if (in_array($type, $message_types)) { + foreach ($messages as $message) { + // @todo: Track as exceptions? + $message_events .= 'ga("send", "event", ' . drupal_json_encode(t('Messages')) . ', ' . drupal_json_encode($status_heading[$type]) . ', ' . drupal_json_encode(strip_tags($message)) . ');'; + } + } + } + } + + // Site search tracking support. + if (module_exists('search') && variable_get('googleanalytics_site_search', FALSE) && arg(0) == 'search' && $keys = googleanalytics_search_get_keys()) { + // hook_preprocess_search_results() is not executed if search result is + // empty. Make sure the counter is set to 0 if there are no results. + $url_custom = '(window.googleanalytics_search_results) ? ' . drupal_json_encode(url('search/' . arg(1), array('query' => array('search' => $keys)))) . ' : ' . drupal_json_encode(url('search/' . arg(1), array('query' => array('search' => 'no-results:' . $keys, 'cat' => 'no-results')))); + } + + // If this node is a translation of another node, pass the original + // node instead. + if (module_exists('translation') && variable_get('googleanalytics_translation_set', 0)) { + // Check we have a node object, it supports translation, and its + // translated node ID (tnid) doesn't match its own node ID. + $node = menu_get_object(); + if ($node && translation_supported_type($node->type) && !empty($node->tnid) && ($node->tnid != $node->nid)) { + $source_node = node_load($node->tnid); + $languages = language_list(); + $url_custom = drupal_json_encode(url('node/' . $source_node->nid, array('language' => $languages[$source_node->language]))); + } + } + + // Track access denied (403) and file not found (404) pages. + if ($status == '403 Forbidden') { + // See https://www.google.com/support/analytics/bin/answer.py?answer=86927 + $url_custom = '"' . $base_path . '403.html?page=" + document.location.pathname + document.location.search + "&from=" + document.referrer'; + } + elseif ($status == '404 Not Found') { + $url_custom = '"' . $base_path . '404.html?page=" + document.location.pathname + document.location.search + "&from=" + document.referrer'; + } + + // #2693595: User has entered an invalid login and clicked on forgot + // password link. This link contains the username or email address and may + // get send to Google if we do not override it. Override only if 'name' + // query param exists. Last custom url condition, this need to win. + // + // URLs to protect are: + // - user/password?name=username + // - user/password?name=foo@example.com + if (arg(0) == 'user' && arg(1) == 'password' && array_key_exists('name', drupal_get_query_parameters())) { + $url_custom = '"' . $base_path . 'user/password"'; + } + + // Add custom dimensions and metrics. + $custom_var = ''; + foreach (array('dimension', 'metric') as $googleanalytics_custom_type) { + $googleanalytics_custom_vars = variable_get('googleanalytics_custom_' . $googleanalytics_custom_type, array()); + // Are there dimensions or metrics configured? + if (!empty($googleanalytics_custom_vars)) { + // Add all the configured variables to the content. + foreach ($googleanalytics_custom_vars as $googleanalytics_custom_var) { + // Replace tokens in values. + $types = array(); + $node = menu_get_object(); + if (is_object($node)) { + $types += array('node' => $node); + } + $googleanalytics_custom_var['value'] = token_replace($googleanalytics_custom_var['value'], $types, array('clear' => TRUE)); + + // Suppress empty values. + if (!drupal_strlen(trim($googleanalytics_custom_var['value']))) { + continue; + } + + // Per documentation the max length of a dimension is 150 bytes. + // A metric has no length limitation. It's not documented if this + // limit means 150 bytes after url encoding or before. + // See https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#customs + if ($googleanalytics_custom_type == 'dimension' && drupal_strlen($googleanalytics_custom_var['value']) > 150) { + $googleanalytics_custom_var['value'] = substr($googleanalytics_custom_var['value'], 0, 150); + } + + // Cast metric values for json_encode to data type numeric. + if ($googleanalytics_custom_type == 'metric') { + settype($googleanalytics_custom_var['value'], 'float'); + }; + + // Add variables to tracker. + $custom_var .= 'ga("set", ' . drupal_json_encode($googleanalytics_custom_type . $googleanalytics_custom_var['index']) . ', ' . drupal_json_encode($googleanalytics_custom_var['value']) . ');'; + } + } + } + + // Build tracker code. + $script = '(function(i,s,o,g,r,a,m){'; + $script .= 'i["GoogleAnalyticsObject"]=r;i[r]=i[r]||function(){'; + $script .= '(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),'; + $script .= 'm=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)'; + $script .= '})(window,document,"script",'; + + // Which version of the tracking library should be used? + $library_tracker_url = 'https://www.google-analytics.com/' . ($debug ? 'analytics_debug.js' : 'analytics.js'); + + // Should a local cached copy of analytics.js be used? + if (variable_get('googleanalytics_cache', 0) && $url = _googleanalytics_cache($library_tracker_url)) { + // A dummy query-string is added to filenames, to gain control over + // browser-caching. The string changes on every update or full cache + // flush, forcing browsers to load a new copy of the files, as the + // URL changed. + $query_string = '?' . variable_get('css_js_query_string', '0'); + + $script .= '"' . $url . $query_string . '"'; + } + else { + $script .= '"' . $library_tracker_url . '"'; + } + $script .= ',"ga");'; + + // Add any custom code snippets if specified. + $codesnippet_create = variable_get('googleanalytics_codesnippet_create', array()); + $codesnippet_before = variable_get('googleanalytics_codesnippet_before', ''); + $codesnippet_after = variable_get('googleanalytics_codesnippet_after', ''); + + // Build the create only fields list. + $create_only_fields = array('cookieDomain' => 'auto'); + $create_only_fields = array_merge($create_only_fields, $codesnippet_create); + + // Domain tracking type. + global $cookie_domain; + $domain_mode = variable_get('googleanalytics_domain_mode', 0); + $googleanalytics_adsense_script = ''; + + // Per RFC 2109, cookie domains must contain at least one dot other than the + // first. For hosts such as 'localhost' or IP Addresses we don't set a cookie domain. + if ($domain_mode == 1 && count(explode('.', $cookie_domain)) > 2 && !is_numeric(str_replace('.', '', $cookie_domain))) { + $create_only_fields = array_merge($create_only_fields, array('cookieDomain' => $cookie_domain)); + $googleanalytics_adsense_script .= 'window.google_analytics_domain_name = ' . drupal_json_encode($cookie_domain) . ';'; + } + elseif ($domain_mode == 2) { + // Cross Domain tracking. 'autoLinker' need to be enabled in 'create'. + $create_only_fields = array_merge($create_only_fields, array('allowLinker' => TRUE)); + $googleanalytics_adsense_script .= 'window.google_analytics_domain_name = "none";'; + } + + // Track logged in users across all devices. + if (variable_get('googleanalytics_trackuserid', 0) && user_is_logged_in()) { + $create_only_fields['userId'] = google_analytics_user_id_hash($user->uid); + } + + // Create a tracker. + $script .= 'ga("create", ' . drupal_json_encode($id) . ', ' . drupal_json_encode($create_only_fields) .');'; + + // Prepare Adsense tracking. + $googleanalytics_adsense_script .= 'window.google_analytics_uacct = ' . drupal_json_encode($id) . ';'; + + // Add enhanced link attribution after 'create', but before 'pageview' send. + // @see https://support.google.com/analytics/answer/2558867 + if (variable_get('googleanalytics_tracklinkid', 0)) { + $script .= 'ga("require", "linkid", "linkid.js");'; + } + + // Add display features after 'create', but before 'pageview' send. + // @see https://support.google.com/analytics/answer/2444872 + if (variable_get('googleanalytics_trackdoubleclick', 0)) { + $script .= 'ga("require", "displayfeatures");'; + } + + // Domain tracking type. + if ($domain_mode == 2) { + // Cross Domain tracking + // https://developers.google.com/analytics/devguides/collection/upgrade/reference/gajs-analyticsjs#cross-domain + $script .= 'ga("require", "linker");'; + $script .= 'ga("linker:autoLink", ' . drupal_json_encode($link_settings['trackCrossDomains']) . ');'; + } + + if (variable_get('googleanalytics_tracker_anonymizeip', 1)) { + $script .= 'ga("set", "anonymizeIp", true);'; + } + + if (!empty($custom_var)) { + $script .= $custom_var; + } + if (!empty($codesnippet_before)) { + $script .= $codesnippet_before; + } + if (!empty($url_custom)) { + $script .= 'ga("set", "page", ' . $url_custom . ');'; + } + $script .= 'ga("send", "pageview");'; + + if (!empty($message_events)) { + $script .= $message_events; + } + if (!empty($codesnippet_after)) { + $script .= $codesnippet_after; + } + + if (variable_get('googleanalytics_trackadsense', FALSE)) { + // Custom tracking. Prepend before all other JavaScript. + // @TODO: https://support.google.com/adsense/answer/98142 + // sounds like it could be appended to $script. + drupal_add_js($googleanalytics_adsense_script, array('type' => 'inline', 'group' => JS_LIBRARY-1, 'requires_jquery' => FALSE)); + } + + drupal_add_js($script, array('scope' => 'header', 'type' => 'inline', 'requires_jquery' => FALSE)); + } +} + +/** + * Generate user id hash to implement USER_ID. + * + * The USER_ID value should be a unique, persistent, and non-personally + * identifiable string identifier that represents a user or signed-in + * account across devices. + * + * @param int $uid + * User id. + * + * @return string + * User id hash. + */ +function google_analytics_user_id_hash($uid) { + return drupal_hmac_base64($uid, drupal_get_private_key() . drupal_get_hash_salt()); +} + +/** + * Implements hook_field_extra_fields(). + */ +function googleanalytics_field_extra_fields() { + $extra['user']['user']['form']['googleanalytics'] = array( + 'label' => t('Google Analytics configuration'), + 'description' => t('Google Analytics module form element.'), + 'weight' => 3, + ); + + return $extra; +} + +/** + * Implements hook_form_FORM_ID_alter(). + * + * Allow users to decide if tracking code will be added to pages or not. + */ +function googleanalytics_form_user_profile_form_alter(&$form, &$form_state) { + $account = $form['#user']; + $category = $form['#user_category']; + + if ($category == 'account' && user_access('opt-in or out of tracking') && ($custom = variable_get('googleanalytics_custom', 0)) != 0 && _googleanalytics_visibility_roles($account)) { + $form['googleanalytics'] = array( + '#type' => 'fieldset', + '#title' => t('Google Analytics configuration'), + '#weight' => 3, + '#collapsible' => TRUE, + '#tree' => TRUE + ); + + switch ($custom) { + case 1: + $description = t('Users are tracked by default, but you are able to opt out.'); + break; + + case 2: + $description = t('Users are not tracked by default, but you are able to opt in.'); + break; + } + + // Disable tracking for visitors who have opted out from tracking via DNT (Do-Not-Track) header. + $disabled = FALSE; + if (variable_get('googleanalytics_privacy_donottrack', 1) && !empty($_SERVER['HTTP_DNT'])) { + $disabled = TRUE; + + // Override settings value. + $account->data['googleanalytics']['custom'] = FALSE; + + $description .= ''; + $description .= ' ' . t('You have opted out from tracking via browser privacy settings.'); + $description .= ''; + } + + $form['googleanalytics']['custom'] = array( + '#type' => 'checkbox', + '#title' => t('Enable user tracking'), + '#description' => $description, + '#default_value' => isset($account->data['googleanalytics']['custom']) ? $account->data['googleanalytics']['custom'] : ($custom == 1), + '#disabled' => $disabled, + ); + + return $form; + } +} + +/** + * Implements hook_user_presave(). + */ +function googleanalytics_user_presave(&$edit, $account, $category) { + if (isset($edit['googleanalytics']['custom'])) { + $edit['data']['googleanalytics']['custom'] = $edit['googleanalytics']['custom']; + } +} + +/** + * Implements hook_cron(). + */ +function googleanalytics_cron() { + // Regenerate the tracking code file every day. + if (REQUEST_TIME - variable_get('googleanalytics_last_cache', 0) >= 86400 && variable_get('googleanalytics_cache', 0)) { + _googleanalytics_cache('https://www.google-analytics.com/analytics.js', TRUE); + variable_set('googleanalytics_last_cache', REQUEST_TIME); + } +} + +/** + * Implements hook_preprocess_search_results(). + * + * Collects and adds the number of search results to the head. + */ +function googleanalytics_preprocess_search_results(&$variables) { + if (variable_get('googleanalytics_site_search', FALSE)) { + // There is no search result $variable available that hold the number of items + // found. But the pager item mumber can tell the number of search results. + global $pager_total_items; + + drupal_add_js('window.googleanalytics_search_results = ' . intval($pager_total_items[0]) . ';', array('type' => 'inline', 'group' => JS_LIBRARY-1, 'requires_jquery' => FALSE)); + } +} + +/** + * Helper function for grabbing search keys. Function is missing in D7. + * + * https://api.drupal.org/api/function/search_get_keys/6 + */ +function googleanalytics_search_get_keys() { + static $return; + if (!isset($return)) { + // Extract keys as remainder of path + // Note: support old GET format of searches for existing links. + $path = explode('/', $_GET['q'], 3); + $keys = empty($_REQUEST['keys']) ? '' : $_REQUEST['keys']; + $return = count($path) == 3 ? $path[2] : $keys; + } + return $return; +} + +/** + * Download/Synchronize/Cache tracking code file locally. + * + * @param $location + * The full URL to the external javascript file. + * @param $synchronize + * Synchronize to local cache if remote file has changed. + * @return mixed + * The path to the local javascript file on success, boolean FALSE on failure. + */ +function _googleanalytics_cache($location, $synchronize = FALSE) { + $path = 'public://googleanalytics'; + $file_destination = $path . '/' . basename($location); + + if (!file_exists($file_destination) || $synchronize) { + // Download the latest tracking code. + $result = drupal_http_request($location); + + if ($result->code == 200) { + if (file_exists($file_destination)) { + // Synchronize tracking code and and replace local file if outdated. + $data_hash_local = drupal_hash_base64(file_get_contents($file_destination)); + $data_hash_remote = drupal_hash_base64($result->data); + // Check that the files directory is writable. + if ($data_hash_local != $data_hash_remote && file_prepare_directory($path)) { + // Save updated tracking code file to disk. + file_unmanaged_save_data($result->data, $file_destination, FILE_EXISTS_REPLACE); + // Based on Drupal Core drupal_build_css_cache(). + if (variable_get('css_gzip_compression', TRUE) && variable_get('clean_url', 0) && extension_loaded('zlib')) { + file_unmanaged_save_data(gzencode($result->data, 9, FORCE_GZIP), $file_destination . '.gz', FILE_EXISTS_REPLACE); + } + watchdog('googleanalytics', 'Locally cached tracking code file has been updated.', array(), WATCHDOG_INFO); + + // Change query-strings on css/js files to enforce reload for all users. + _drupal_flush_css_js(); + } + } + else { + // Check that the files directory is writable. + if (file_prepare_directory($path, FILE_CREATE_DIRECTORY)) { + // There is no need to flush JS here as core refreshes JS caches + // automatically, if new files are added. + file_unmanaged_save_data($result->data, $file_destination, FILE_EXISTS_REPLACE); + // Based on Drupal Core drupal_build_css_cache(). + if (variable_get('css_gzip_compression', TRUE) && variable_get('clean_url', 0) && extension_loaded('zlib')) { + file_unmanaged_save_data(gzencode($result->data, 9, FORCE_GZIP), $file_destination . '.gz', FILE_EXISTS_REPLACE); + } + watchdog('googleanalytics', 'Locally cached tracking code file has been saved.', array(), WATCHDOG_INFO); + + // Return the local JS file path. + return file_create_url($file_destination); + } + } + } + } + else { + // Return the local JS file path. + return file_create_url($file_destination); + } +} + +/** + * Delete cached files and directory. + */ +function googleanalytics_clear_js_cache() { + $path = 'public://googleanalytics'; + if (file_prepare_directory($path)) { + file_scan_directory($path, '/.*/', array('callback' => 'file_unmanaged_delete')); + drupal_rmdir($path); + + // Change query-strings on css/js files to enforce reload for all users. + _drupal_flush_css_js(); + + watchdog('googleanalytics', 'Local cache has been purged.', array(), WATCHDOG_INFO); + } +} + +/** + * Tracking visibility check for an user object. + * + * @param $account + * A user object containing an array of roles to check. + * @return boolean + * A decision on if the current user is being tracked by Google Analytics. + */ +function _googleanalytics_visibility_user($account) { + + $enabled = FALSE; + + // Is current user a member of a role that should be tracked? + if (_googleanalytics_visibility_header($account) && _googleanalytics_visibility_roles($account)) { + + // Use the user's block visibility setting, if necessary. + if (($custom = variable_get('googleanalytics_custom', 0)) != 0) { + if ($account->uid && isset($account->data['googleanalytics']['custom'])) { + $enabled = $account->data['googleanalytics']['custom']; + } + else { + $enabled = ($custom == 1); + } + } + else { + $enabled = TRUE; + } + + } + + return $enabled; +} + +/** + * Based on visibility setting this function returns TRUE if GA code should + * be added for the current role and otherwise FALSE. + */ +function _googleanalytics_visibility_roles($account) { + + $visibility = variable_get('googleanalytics_visibility_roles', 0); + $enabled = $visibility; + $roles = variable_get('googleanalytics_roles', array()); + + if (array_sum($roles) > 0) { + // One or more roles are selected. + foreach (array_keys($account->roles) as $rid) { + // Is the current user a member of one of these roles? + if (isset($roles[$rid]) && $rid == $roles[$rid]) { + // Current user is a member of a role that should be tracked/excluded from tracking. + $enabled = !$visibility; + break; + } + } + } + else { + // No role is selected for tracking, therefore all roles should be tracked. + $enabled = TRUE; + } + + return $enabled; +} + +/** + * Based on visibility setting this function returns TRUE if GA code should + * be added to the current page and otherwise FALSE. + */ +function _googleanalytics_visibility_pages() { + static $page_match; + + // Cache visibility result if function is called more than once. + if (!isset($page_match)) { + + $visibility = variable_get('googleanalytics_visibility_pages', 0); + $setting_pages = variable_get('googleanalytics_pages', GOOGLEANALYTICS_PAGES); + + // Match path if necessary. + if (!empty($setting_pages)) { + // Convert path to lowercase. This allows comparison of the same path + // with different case. Ex: /Page, /page, /PAGE. + $pages = drupal_strtolower($setting_pages); + if ($visibility < 2) { + // Convert the Drupal path to lowercase + $path = drupal_strtolower(drupal_get_path_alias($_GET['q'])); + // Compare the lowercase internal and lowercase path alias (if any). + $page_match = drupal_match_path($path, $pages); + if ($path != $_GET['q']) { + $page_match = $page_match || drupal_match_path($_GET['q'], $pages); + } + // When $visibility has a value of 0, the tracking code is displayed on + // all pages except those listed in $pages. When set to 1, it + // is displayed only on those pages listed in $pages. + $page_match = !($visibility xor $page_match); + } + elseif (module_exists('php')) { + $page_match = php_eval($setting_pages); + } + else { + $page_match = FALSE; + } + } + else { + $page_match = TRUE; + } + + } + return $page_match; +} + +/** + * Based on headers send by clients this function returns TRUE if GA code should + * be added to the current page and otherwise FALSE. + */ +function _googleanalytics_visibility_header($account) { + + if (($account->uid || variable_get('cache', 0) == 0) && variable_get('googleanalytics_privacy_donottrack', 1) && !empty($_SERVER['HTTP_DNT'])) { + // Disable tracking if caching is disabled or a visitors is logged in and + // have opted out from tracking via DNT (Do-Not-Track) header. + return FALSE; + } + + return TRUE; +} diff --git a/googleanalytics.test b/googleanalytics.test new file mode 100644 index 0000000..52c3148 --- /dev/null +++ b/googleanalytics.test @@ -0,0 +1,819 @@ + 'Google Analytics basic tests', + 'description' => 'Test basic functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + 'administer modules', + 'administer site configuration', + ); + + // User to set up google_analytics. + $this->noSnippetUser = $this->drupalCreateUser($permissions); + $permissions[] = 'add JS snippets for google analytics'; + $this->admin_user = $this->drupalCreateUser($permissions); + $this->drupalLogin($this->admin_user); + } + + function testGoogleAnalyticsConfiguration() { + // Check if Configure link is available on 'Modules' page. + // Requires 'administer modules' permission. + $this->drupalGet('admin/modules'); + $this->assertRaw('admin/config/system/googleanalytics', '[testGoogleAnalyticsConfiguration]: Configure link from Modules page to Google Analytics Settings page exists.'); + + // Check if Configure link is available on 'Status Reports' page. NOTE: Link is only shown without UA code configured. + // Requires 'administer site configuration' permission. + $this->drupalGet('admin/reports/status'); + $this->assertRaw('admin/config/system/googleanalytics', '[testGoogleAnalyticsConfiguration]: Configure link from Status Reports page to Google Analytics Settings page exists.'); + + // Check for setting page's presence. + $this->drupalGet('admin/config/system/googleanalytics'); + $this->assertRaw(t('Web Property ID'), '[testGoogleAnalyticsConfiguration]: Settings page displayed.'); + + // Check for account code validation. + $edit['googleanalytics_account'] = $this->randomName(2); + $this->drupalPost('admin/config/system/googleanalytics', $edit, t('Save configuration')); + $this->assertRaw(t('A valid Google Analytics Web Property ID is case sensitive and formatted like UA-xxxxxxx-yy.'), '[testGoogleAnalyticsConfiguration]: Invalid Web Property ID number validated.'); + + // User should have access to code snippets. + $this->assertFieldByName('googleanalytics_codesnippet_create'); + $this->assertFieldByName('googleanalytics_codesnippet_before'); + $this->assertFieldByName('googleanalytics_codesnippet_after'); + $this->assertNoFieldByXPath("//textarea[@name='googleanalytics_codesnippet_create' and @disabled='disabled']", NULL, '"Create only fields" is enabled.'); + $this->assertNoFieldByXPath("//textarea[@name='googleanalytics_codesnippet_before' and @disabled='disabled']", NULL, '"Code snippet (before)" is enabled.'); + $this->assertNoFieldByXPath("//textarea[@name='googleanalytics_codesnippet_after' and @disabled='disabled']", NULL, '"Code snippet (after)" is enabled.'); + + // Login as user without JS permissions. + $this->drupalLogin($this->noSnippetUser); + $this->drupalGet('admin/config/system/googleanalytics'); + + // User should *not* have access to snippets, but create fields. + $this->assertFieldByName('googleanalytics_codesnippet_create'); + $this->assertFieldByName('googleanalytics_codesnippet_before'); + $this->assertFieldByName('googleanalytics_codesnippet_after'); + $this->assertNoFieldByXPath("//textarea[@name='googleanalytics_codesnippet_create' and @disabled='disabled']", NULL, '"Create only fields" is enabled.'); + $this->assertFieldByXPath("//textarea[@name='googleanalytics_codesnippet_before' and @disabled='disabled']", NULL, '"Code snippet (before)" is disabled.'); + $this->assertFieldByXPath("//textarea[@name='googleanalytics_codesnippet_after' and @disabled='disabled']", NULL, '"Code snippet (after)" is disabled.'); + } + + function testGoogleAnalyticsPageVisibility() { + // Verify that no tracking code is embedded into the webpage; if there is + // only the module installed, but UA code not configured. See #2246991. + $this->drupalGet(''); + $this->assertNoRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPageVisibility]: Tracking code is not displayed without UA code configured.'); + + $ua_code = 'UA-123456-1'; + variable_set('googleanalytics_account', $ua_code); + + // Show tracking on "every page except the listed pages". + variable_set('googleanalytics_visibility_pages', 0); + // Disable tracking on "admin*" pages only. + variable_set('googleanalytics_pages', "admin\nadmin/*"); + // Enable tracking only for authenticated users only. + variable_set('googleanalytics_roles', array(DRUPAL_AUTHENTICATED_RID => DRUPAL_AUTHENTICATED_RID)); + + // Check tracking code visibility. + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsPageVisibility]: Tracking code is displayed for authenticated users.'); + + // Test whether tracking code is not included on pages to omit. + $this->drupalGet('admin'); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsPageVisibility]: Tracking code is not displayed on admin page.'); + $this->drupalGet('admin/config/system/googleanalytics'); + // Checking for tracking code URI here, as $ua_code is displayed in the form. + $this->assertNoRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPageVisibility]: Tracking code is not displayed on admin subpage.'); + + // Test whether tracking code display is properly flipped. + variable_set('googleanalytics_visibility_pages', 1); + $this->drupalGet('admin'); + $this->assertRaw($ua_code, '[testGoogleAnalyticsPageVisibility]: Tracking code is displayed on admin page.'); + $this->drupalGet('admin/config/system/googleanalytics'); + // Checking for tracking code URI here, as $ua_code is displayed in the form. + $this->assertRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPageVisibility]: Tracking code is displayed on admin subpage.'); + $this->drupalGet(''); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsPageVisibility]: Tracking code is NOT displayed on front page.'); + + // Test whether tracking code is not display for anonymous. + $this->drupalLogout(); + $this->drupalGet(''); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsPageVisibility]: Tracking code is NOT displayed for anonymous.'); + + // Switch back to every page except the listed pages. + variable_set('googleanalytics_visibility_pages', 0); + // Enable tracking code for all user roles. + variable_set('googleanalytics_roles', array()); + + $base_path = base_path(); + + // Test whether 403 forbidden tracking code is shown if user has no access. + $this->drupalGet('admin'); + $this->assertRaw($base_path . '403.html', '[testGoogleAnalyticsPageVisibility]: 403 Forbidden tracking code shown if user has no access.'); + + // Test whether 404 not found tracking code is shown on non-existent pages. + $this->drupalGet($this->randomName(64)); + $this->assertRaw($base_path . '404.html', '[testGoogleAnalyticsPageVisibility]: 404 Not Found tracking code shown on non-existent page.'); + + // DNT Tests: + // Enable system internal page cache for anonymous users. + variable_set('cache', 1); + // Test whether DNT headers will fail to disable embedding of tracking code. + $this->drupalGet('', array(), array('DNT: 1')); + $this->assertRaw('ga("send", "pageview");', '[testGoogleAnalyticsDNTVisibility]: DNT header send from client, but page caching is enabled and tracker cannot removed.'); + // DNT works only with system internal page cache for anonymous users disabled. + variable_set('cache', 0); + $this->drupalGet(''); + $this->assertRaw('ga("send", "pageview");', '[testGoogleAnalyticsDNTVisibility]: Tracking is enabled without DNT header.'); + // Test whether DNT header is able to remove the tracking code. + $this->drupalGet('', array(), array('DNT: 1')); + $this->assertNoRaw('ga("send", "pageview");', '[testGoogleAnalyticsDNTVisibility]: DNT header received from client. Tracking has been disabled by browser.'); + // Disable DNT feature and see if tracker is still embedded. + variable_set('googleanalytics_privacy_donottrack', 0); + $this->drupalGet('', array(), array('DNT: 1')); + $this->assertRaw('ga("send", "pageview");', '[testGoogleAnalyticsDNTVisibility]: DNT feature is disabled, DNT header from browser has been ignored.'); + } + + function testGoogleAnalyticsTrackingCode() { + $ua_code = 'UA-123456-2'; + variable_set('googleanalytics_account', $ua_code); + + // Show tracking code on every page except the listed pages. + variable_set('googleanalytics_visibility_pages', 0); + // Enable tracking code for all user roles. + variable_set('googleanalytics_roles', array()); + + /* Sample JS code as added to page: + + + + */ + + // Test whether tracking code uses latest JS. + variable_set('googleanalytics_cache', 0); + $this->drupalGet(''); + $this->assertRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsTrackingCode]: Latest tracking code used.'); + + // Test whether anonymize visitors IP address feature has been enabled. + variable_set('googleanalytics_tracker_anonymizeip', 0); + $this->drupalGet(''); + $this->assertNoRaw('ga("set", "anonymizeIp", true);', '[testGoogleAnalyticsTrackingCode]: Anonymize visitors IP address not found on frontpage.'); + // Enable anonymizing of IP addresses. + variable_set('googleanalytics_tracker_anonymizeip', 1); + $this->drupalGet(''); + $this->assertRaw('ga("set", "anonymizeIp", true);', '[testGoogleAnalyticsTrackingCode]: Anonymize visitors IP address found on frontpage.'); + + // Test if track Enhanced Link Attribution is enabled. + variable_set('googleanalytics_tracklinkid', 1); + $this->drupalGet(''); + $this->assertRaw('ga("require", "linkid", "linkid.js");', '[testGoogleAnalyticsTrackingCode]: Tracking code for Enhanced Link Attribution is enabled.'); + + // Test if track Enhanced Link Attribution is disabled. + variable_set('googleanalytics_tracklinkid', 0); + $this->drupalGet(''); + $this->assertNoRaw('ga("require", "linkid", "linkid.js");', '[testGoogleAnalyticsTrackingCode]: Tracking code for Enhanced Link Attribution is not enabled.'); + + // Test if tracking of User ID is enabled. + variable_set('googleanalytics_trackuserid', 1); + $this->drupalGet(''); + $this->assertRaw(', {"cookieDomain":"auto","userId":"', '[testGoogleAnalyticsTrackingCode]: Tracking code for User ID is enabled.'); + + // Test if tracking of User ID is disabled. + variable_set('googleanalytics_trackuserid', 0); + $this->drupalGet(''); + $this->assertNoRaw(', {"cookieDomain":"auto","userId":"', '[testGoogleAnalyticsTrackingCode]: Tracking code for User ID is disabled.'); + + // Test if tracking of url fragments is enabled. + variable_set('googleanalytics_trackurlfragments', 1); + $this->drupalGet(''); + $this->assertRaw('ga("set", "page", location.pathname + location.search + location.hash);', '[testGoogleAnalyticsTrackingCode]: Tracking code for url fragments is enabled.'); + + // Test if tracking of url fragments is disabled. + variable_set('googleanalytics_trackurlfragments', 0); + $this->drupalGet(''); + $this->assertNoRaw('ga("set", "page", location.pathname + location.search + location.hash);', '[testGoogleAnalyticsTrackingCode]: Tracking code for url fragments is not enabled.'); + + // Test if track display features is enabled. + variable_set('googleanalytics_trackdoubleclick', 1); + $this->drupalGet(''); + $this->assertRaw('ga("require", "displayfeatures");', '[testGoogleAnalyticsTrackingCode]: Tracking code for display features is enabled.'); + + // Test if track display features is disabled. + variable_set('googleanalytics_trackdoubleclick', 0); + $this->drupalGet(''); + $this->assertNoRaw('ga("require", "displayfeatures");', '[testGoogleAnalyticsTrackingCode]: Tracking code for display features is not enabled.'); + + // Test whether single domain tracking is active. + $this->drupalGet(''); + $this->assertRaw('{"cookieDomain":"auto"}', '[testGoogleAnalyticsTrackingCode]: Single domain tracking is active.'); + + // Enable "One domain with multiple subdomains". + variable_set('googleanalytics_domain_mode', 1); + $this->drupalGet(''); + + // Test may run on localhost, an ipaddress or real domain name. + // TODO: Workaround to run tests successfully. This feature cannot tested reliable. + global $cookie_domain; + if (count(explode('.', $cookie_domain)) > 2 && !is_numeric(str_replace('.', '', $cookie_domain))) { + $this->assertRaw('{"cookieDomain":"' . $cookie_domain . '"}', '[testGoogleAnalyticsTrackingCode]: One domain with multiple subdomains is active on real host.'); + } + else { + // Special cases, Localhost and IP addresses don't show '_setDomainName'. + $this->assertNoRaw('{"cookieDomain":"' . $cookie_domain . '"}', '[testGoogleAnalyticsTrackingCode]: One domain with multiple subdomains may be active on localhost (test result is not reliable).'); + } + + // Enable "Multiple top-level domains" tracking. + variable_set('googleanalytics_domain_mode', 2); + variable_set('googleanalytics_cross_domains', "www.example.com\nwww.example.net"); + $this->drupalGet(''); + $this->assertRaw('ga("create", "' . $ua_code . '", {"cookieDomain":"auto","allowLinker":true', '[testGoogleAnalyticsTrackingCode]: "allowLinker" has been found. Cross domain tracking is active.'); + $this->assertRaw('ga("require", "linker");', '[testGoogleAnalyticsTrackingCode]: Require linker has been found. Cross domain tracking is active.'); + $this->assertRaw('ga("linker:autoLink", ["www.example.com","www.example.net"]);', '[testGoogleAnalyticsTrackingCode]: "linker:autoLink" has been found. Cross domain tracking is active.'); + $this->assertRaw('"trackDomainMode":2,', '[testGoogleAnalyticsTrackingCode]: Domain mode value is of type integer.'); + $this->assertRaw('"trackCrossDomains":["www.example.com","www.example.net"]', '[testGoogleAnalyticsTrackingCode]: Cross domain tracking with www.example.com and www.example.net is active.'); + variable_set('googleanalytics_domain_mode', 0); + + // Test whether debugging script has been enabled. + variable_set('googleanalytics_debug', 1); + $this->drupalGet(''); + $this->assertRaw('https://www.google-analytics.com/analytics_debug.js', '[testGoogleAnalyticsTrackingCode]: Google debugging script has been enabled.'); + + // Check if text and link is shown on 'Status Reports' page. + // Requires 'administer site configuration' permission. + $this->drupalGet('admin/reports/status'); + $this->assertRaw(t('Google Analytics module has debugging enabled. Please disable debugging setting in production sites from the Google Analytics settings page.', array('@url' => url('admin/config/system/googleanalytics'))), '[testGoogleAnalyticsConfiguration]: Debugging enabled is shown on Status Reports page.'); + + // Test whether debugging script has been disabled. + variable_set('googleanalytics_debug', 0); + $this->drupalGet(''); + $this->assertRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsTrackingCode]: Google debugging script has been disabled.'); + + // Test whether the CREATE and BEFORE and AFTER code is added to the tracker. + $codesnippet_create = array( + 'cookieDomain' => 'foo.example.com', + 'cookieName' => 'myNewName', + 'cookieExpires' => 20000, + 'allowAnchor' => TRUE, + 'sampleRate' => 4.3, + ); + variable_set('googleanalytics_codesnippet_create', $codesnippet_create); + variable_set('googleanalytics_codesnippet_before', 'ga("set", "forceSSL", true);'); + variable_set('googleanalytics_codesnippet_after', 'ga("create", "UA-123456-3", {"name": "newTracker"});ga("newTracker.send", "pageview");'); + $this->drupalGet(''); + $this->assertRaw('ga("create", "' . $ua_code . '", {"cookieDomain":"foo.example.com","cookieName":"myNewName","cookieExpires":20000,"allowAnchor":true,"sampleRate":4.3});', '[testGoogleAnalyticsTrackingCode]: Create only fields have been found.'); + $this->assertRaw('ga("set", "forceSSL", true);', '[testGoogleAnalyticsTrackingCode]: Before codesnippet will force http pages to also send all beacons using https.'); + $this->assertRaw('ga("create", "UA-123456-3", {"name": "newTracker"});', '[testGoogleAnalyticsTrackingCode]: After codesnippet with "newTracker" tracker has been found.'); + } +} + +class GoogleAnalyticsCustomDimensionsAndMetricsTest extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics custom dimensions and metrics tests', + 'description' => 'Test custom dimensions and metrics functionality of Google Analytics module.', + 'group' => 'Google Analytics', + 'dependencies' => array('token'), + ); + } + + function setUp() { + parent::setUp('googleanalytics', 'token'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + ); + + // User to set up google_analytics. + $this->admin_user = $this->drupalCreateUser($permissions); + $this->drupalLogin($this->admin_user); + } + + function testGoogleAnalyticsCustomDimensions() { + $ua_code = 'UA-123456-3'; + variable_set('googleanalytics_account', $ua_code); + + // Basic test if the feature works. + $googleanalytics_custom_dimension = array( + 1 => array( + 'index' => 1, + 'value' => 'Bar 1', + ), + 2 => array( + 'index' => 2, + 'value' => 'Bar 2', + ), + 3 => array( + 'index' => 3, + 'value' => 'Bar 3', + ), + 4 => array( + 'index' => 4, + 'value' => 'Bar 4', + ), + 5 => array( + 'index' => 5, + 'value' => 'Bar 5', + ), + ); + variable_set('googleanalytics_custom_dimension', $googleanalytics_custom_dimension); + $this->drupalGet(''); + + foreach ($googleanalytics_custom_dimension as $dimension) { + $this->assertRaw('ga("set", ' . drupal_json_encode('dimension' . $dimension['index']) . ', ' . drupal_json_encode($dimension['value']) . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Dimension #' . $dimension['index'] . ' is shown.'); + } + + // Test whether tokens are replaced in custom dimension values. + $site_slogan = $this->randomName(16); + variable_set('site_slogan', $site_slogan); + + $googleanalytics_custom_dimension = array( + 1 => array( + 'index' => 1, + 'value' => 'Value: [site:slogan]', + ), + 2 => array( + 'index' => 2, + 'value' => $this->randomName(16), + ), + 3 => array( + 'index' => 3, + 'value' => '', + ), + // #2300701: Custom dimensions and custom metrics not outputed on zero value. + 4 => array( + 'index' => 4, + 'value' => '0', + ), + ); + variable_set('googleanalytics_custom_dimension', $googleanalytics_custom_dimension); + $this->verbose('
' . print_r($googleanalytics_custom_dimension, TRUE) . '
'); + + $this->drupalGet(''); + $this->assertRaw('ga("set", ' . drupal_json_encode('dimension1') . ', ' . drupal_json_encode("Value: $site_slogan") . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Tokens have been replaced in dimension value.'); + $this->assertRaw('ga("set", ' . drupal_json_encode('dimension2') . ', ' . drupal_json_encode($googleanalytics_custom_dimension['2']['value']) . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Random value is shown.'); + $this->assertNoRaw('ga("set", ' . drupal_json_encode('dimension3') . ', ' . drupal_json_encode('') . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Empty value is not shown.'); + $this->assertRaw('ga("set", ' . drupal_json_encode('dimension4') . ', ' . drupal_json_encode('0') . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Value 0 is shown.'); + } + + function testGoogleAnalyticsCustomMetrics() { + $ua_code = 'UA-123456-3'; + variable_set('googleanalytics_account', $ua_code); + + // Basic test if the feature works. + $googleanalytics_custom_metric = array( + 1 => array( + 'index' => 1, + 'value' => '6', + ), + 2 => array( + 'index' => 2, + 'value' => '8000', + ), + 3 => array( + 'index' => 3, + 'value' => '7.8654', + ), + 4 => array( + 'index' => 4, + 'value' => '1123.4', + ), + 5 => array( + 'index' => 5, + 'value' => '5,67', + ), + ); + + variable_set('googleanalytics_custom_metric', $googleanalytics_custom_metric); + $this->drupalGet(''); + + foreach ($googleanalytics_custom_metric as $metric) { + $this->assertRaw('ga("set", ' . drupal_json_encode('metric' . $metric['index']) . ', ' . drupal_json_encode((float) $metric['value']) . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Metric #' . $metric['index'] . ' is shown.'); + } + + // Test whether tokens are replaced in custom metric values. + $googleanalytics_custom_metric = array( + 1 => array( + 'index' => 1, + 'value' => '[current-user:roles:count]', + ), + 2 => array( + 'index' => 2, + 'value' => mt_rand(), + ), + 3 => array( + 'index' => 3, + 'value' => '', + ), + // #2300701: Custom dimensions and custom metrics not outputed on zero value. + 4 => array( + 'index' => 4, + 'value' => '0', + ), + ); + variable_set('googleanalytics_custom_metric', $googleanalytics_custom_metric); + $this->verbose('
' . print_r($googleanalytics_custom_metric, TRUE) . '
'); + + $this->drupalGet(''); + $this->assertRaw('ga("set", ' . drupal_json_encode('metric1') . ', ', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Tokens have been replaced in metric value.'); + $this->assertRaw('ga("set", ' . drupal_json_encode('metric2') . ', ' . drupal_json_encode($googleanalytics_custom_metric['2']['value']) . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Random value is shown.'); + $this->assertNoRaw('ga("set", ' . drupal_json_encode('metric3') . ', ' . drupal_json_encode('') . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Empty value is not shown.'); + $this->assertRaw('ga("set", ' . drupal_json_encode('metric4') . ', ' . drupal_json_encode(0) . ');', '[testGoogleAnalyticsCustomDimensionsAndMetrics]: Value 0 is shown.'); + } + + /** + * Tests if Custom Dimensions token form validation works. + */ + public function testGoogleAnalyticsCustomDimensionsTokenFormValidation() { + $ua_code = 'UA-123456-1'; + + // Check form validation. + $edit['googleanalytics_account'] = $ua_code; + $edit['googleanalytics_custom_dimension[indexes][1][value]'] = '[current-user:name]'; + $edit['googleanalytics_custom_dimension[indexes][2][value]'] = '[current-user:edit-url]'; + $edit['googleanalytics_custom_dimension[indexes][3][value]'] = '[user:name]'; + $edit['googleanalytics_custom_dimension[indexes][4][value]'] = '[term:name]'; + $edit['googleanalytics_custom_dimension[indexes][5][value]'] = '[term:tid]'; + + $this->drupalPost('admin/config/system/googleanalytics', $edit, t('Save configuration')); + + $this->assertRaw(t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => t('Custom dimension value #@index', array('@index' => 1)), '@invalid-tokens' => implode(', ', array('[current-user:name]'))))); + $this->assertRaw(t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => t('Custom dimension value #@index', array('@index' => 2)), '@invalid-tokens' => implode(', ', array('[current-user:edit-url]'))))); + $this->assertRaw(t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => t('Custom dimension value #@index', array('@index' => 3)), '@invalid-tokens' => implode(', ', array('[user:name]'))))); + // BUG #2037595 + //$this->assertNoRaw(t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => t('Custom dimension value #@index', array('@index' => 4)), '@invalid-tokens' => implode(', ', array('[term:name]'))))); + //$this->assertNoRaw(t('The %element-title is using the following forbidden tokens with personal identifying information: @invalid-tokens.', array('%element-title' => t('Custom dimension value #@index', array('@index' => 5)), '@invalid-tokens' => implode(', ', array('[term:tid]'))))); + } +} + +/** + * Test custom url functionality of Google Analytics module. + */ +class GoogleAnalyticsCustomUrls extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics custom url tests', + 'description' => 'Test custom url functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + ); + + // User to set up google_analytics. + $this->admin_user = $this->drupalCreateUser($permissions); + } + + /** + * Tests if user password page urls are overridden. + */ + public function testGoogleAnalyticsUserPasswordPage() { + $base_path = base_path(); + $ua_code = 'UA-123456-4'; + variable_set('googleanalytics_account', $ua_code); + + $this->drupalGet('user/password', array('query' => array('name' => 'foo'))); + $this->assertRaw('ga("set", "page", "' . $base_path . 'user/password"'); + + $this->drupalGet('user/password', array('query' => array('name' => 'foo@example.com'))); + $this->assertRaw('ga("set", "page", "' . $base_path . 'user/password"'); + + $this->drupalGet('user/password'); + $this->assertNoRaw('ga("set", "page",', '[testGoogleAnalyticsCustomUrls]: Custom url not set.'); + } + +} + +class GoogleAnalyticsStatusMessagesTest extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics status messages tests', + 'description' => 'Test status messages functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + ); + + // User to set up google_analytics. + $this->admin_user = $this->drupalCreateUser($permissions); + } + + function testGoogleAnalyticsStatusMessages() { + $ua_code = 'UA-123456-4'; + variable_set('googleanalytics_account', $ua_code); + + // Enable logging of errors only. + variable_set('googleanalytics_trackmessages', array('error' => 'error')); + + $this->drupalPost('user/login', array(), t('Log in')); + $this->assertRaw('ga("send", "event", "Messages", "Error message", "Username field is required.");', '[testGoogleAnalyticsStatusMessages]: Event message "Username field is required." is shown.'); + $this->assertRaw('ga("send", "event", "Messages", "Error message", "Password field is required.");', '[testGoogleAnalyticsStatusMessages]: Event message "Password field is required." is shown.'); + + // @todo: investigate why drupal_set_message() fails. + //drupal_set_message('Example status message.', 'status'); + //drupal_set_message('Example warning message.', 'warning'); + //drupal_set_message('Example error message.', 'error'); + //drupal_set_message('Example error message with html tags and link.', 'error'); + //$this->drupalGet(''); + //$this->assertNoRaw('ga("send", "event", "Messages", "Status message", "Example status message.");', '[testGoogleAnalyticsStatusMessages]: Example status message is not enabled for tracking.'); + //$this->assertNoRaw('ga("send", "event", "Messages", "Warning message", "Example warning message.");', '[testGoogleAnalyticsStatusMessages]: Example warning message is not enabled for tracking.'); + //$this->assertRaw('ga("send", "event", "Messages", "Error message", "Example error message.");', '[testGoogleAnalyticsStatusMessages]: Example error message is shown.'); + //$this->assertRaw('ga("send", "event", "Messages", "Error message", "Example error message with html tags and link.");', '[testGoogleAnalyticsStatusMessages]: HTML has been stripped successful from Example error message with html tags and link.'); + } +} + +class GoogleAnalyticsRolesTest extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics role tests', + 'description' => 'Test roles functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + ); + + // User to set up google_analytics. + $this->admin_user = $this->drupalCreateUser($permissions); + } + + function testGoogleAnalyticsRolesTracking() { + $ua_code = 'UA-123456-4'; + variable_set('googleanalytics_account', $ua_code); + + // Test if the default settings are working as expected. + + // Add to the selected roles only. + variable_set('googleanalytics_visibility_roles', 0); + // Enable tracking for all users. + variable_set('googleanalytics_roles', array()); + + // Check tracking code visibility. + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is displayed for anonymous users on frontpage with default settings.'); + $this->drupalGet('admin'); + $this->assertRaw('/403.html', '[testGoogleAnalyticsRoleVisibility]: 403 Forbidden tracking code is displayed for anonymous users in admin section with default settings.'); + + $this->drupalLogin($this->admin_user); + + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is displayed for authenticated users on frontpage with default settings.'); + $this->drupalGet('admin'); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is NOT displayed for authenticated users in admin section with default settings.'); + + // Test if the non-default settings are working as expected. + + // Enable tracking only for authenticated users. + variable_set('googleanalytics_roles', array(DRUPAL_AUTHENTICATED_RID => DRUPAL_AUTHENTICATED_RID)); + + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is displayed for authenticated users only on frontpage.'); + + $this->drupalLogout(); + $this->drupalGet(''); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is NOT displayed for anonymous users on frontpage.'); + + // Add to every role except the selected ones. + variable_set('googleanalytics_visibility_roles', 1); + // Enable tracking for all users. + variable_set('googleanalytics_roles', array()); + + // Check tracking code visibility. + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is added to every role and displayed for anonymous users.'); + $this->drupalGet('admin'); + $this->assertRaw('/403.html', '[testGoogleAnalyticsRoleVisibility]: 403 Forbidden tracking code is shown for anonymous users if every role except the selected ones is selected.'); + + $this->drupalLogin($this->admin_user); + + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is added to every role and displayed on frontpage for authenticated users.'); + $this->drupalGet('admin'); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is added to every role and NOT displayed in admin section for authenticated users.'); + + // Disable tracking for authenticated users. + variable_set('googleanalytics_roles', array(DRUPAL_AUTHENTICATED_RID => DRUPAL_AUTHENTICATED_RID)); + + $this->drupalGet(''); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is NOT displayed on frontpage for excluded authenticated users.'); + $this->drupalGet('admin'); + $this->assertNoRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is NOT displayed in admin section for excluded authenticated users.'); + + $this->drupalLogout(); + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsRoleVisibility]: Tracking code is displayed on frontpage for included anonymous users.'); + } +} + +class GoogleAnalyticsSearchTest extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics search tests', + 'description' => 'Test search functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics', 'search', 'node'); + + $permissions = array( + 'access administration pages', + 'administer google analytics', + 'search content', + 'create page content', + 'edit own page content', + ); + + // User to set up google_analytics. + $this->admin_user = $this->drupalCreateUser($permissions); + $this->drupalLogin($this->admin_user); + } + + function testGoogleAnalyticsSearchTracking() { + $ua_code = 'UA-123456-1'; + variable_set('googleanalytics_account', $ua_code); + + // Check tracking code visibility. + $this->drupalGet(''); + $this->assertRaw($ua_code, '[testGoogleAnalyticsSearch]: Tracking code is displayed for authenticated users.'); + + $this->drupalGet('search/node'); + $this->assertNoRaw('ga("set", "page",', '[testGoogleAnalyticsSearch]: Custom url not set.'); + + // Enable site search support. + variable_set('googleanalytics_site_search', 1); + + // Search for random string. + $search = array(); + $search['keys'] = $this->randomName(8); + + // Create a node to search for. + $langcode = LANGUAGE_NONE; + $edit = array(); + $edit['title'] = 'This is a test title'; + $edit["body[$langcode][0][value]"] = 'This test content contains ' . $search['keys'] . ' string.'; + + // Fire a search, it's expected to get 0 results. + $this->drupalPost('search/node', $search, t('Search')); + $this->assertRaw('ga("set", "page", (window.googleanalytics_search_results) ?', '[testGoogleAnalyticsSearch]: Search results tracker is displayed.'); + $this->assertRaw('window.googleanalytics_search_results = 0;', '[testGoogleAnalyticsSearch]: Search yielded no results.'); + + // Save the node. + $this->drupalPost('node/add/page', $edit, t('Save')); + $this->assertText(t('@type @title has been created.', array('@type' => 'Basic page', '@title' => $edit['title'])), 'Node was created.'); + + // Index the node or it cannot found. + $this->cronRun(); + + $this->drupalPost('search/node', $search, t('Search')); + $this->assertRaw('ga("set", "page", (window.googleanalytics_search_results) ?', '[testGoogleAnalyticsSearch]: Search results tracker is displayed.'); + $this->assertRaw('window.googleanalytics_search_results = 1;', '[testGoogleAnalyticsSearch]: One search result found.'); + + $this->drupalPost('node/add/page', $edit, t('Save')); + $this->assertText(t('@type @title has been created.', array('@type' => 'Basic page', '@title' => $edit['title'])), 'Node was created.'); + + // Index the node or it cannot found. + $this->cronRun(); + + $this->drupalPost('search/node', $search, t('Search')); + $this->assertRaw('ga("set", "page", (window.googleanalytics_search_results) ?', '[testGoogleAnalyticsSearch]: Search results tracker is displayed.'); + $this->assertRaw('window.googleanalytics_search_results = 2;', '[testGoogleAnalyticsSearch]: Two search results found.'); + } + +} + +class GoogleAnalyticsPhpFilterTest extends DrupalWebTestCase { + + public static function getInfo() { + return array( + 'name' => 'Google Analytics php filter tests', + 'description' => 'Test php filter functionality of Google Analytics module.', + 'group' => 'Google Analytics', + ); + } + + function setUp() { + parent::setUp('googleanalytics', 'php'); + + // Administrator with all permissions. + $permissions_admin_user = array( + 'access administration pages', + 'administer google analytics', + 'use PHP for tracking visibility', + ); + $this->admin_user = $this->drupalCreateUser($permissions_admin_user); + + // Administrator who cannot configure tracking visibility with PHP. + $permissions_delegated_admin_user = array( + 'access administration pages', + 'administer google analytics', + ); + $this->delegated_admin_user = $this->drupalCreateUser($permissions_delegated_admin_user); + } + + function testGoogleAnalyticsPhpFilter() { + $ua_code = 'UA-123456-1'; + $this->drupalLogin($this->admin_user); + + $edit = array(); + $edit['googleanalytics_account'] = $ua_code; + $edit['googleanalytics_visibility_pages'] = 2; + $edit['googleanalytics_pages'] = ''; + $this->drupalPost('admin/config/system/googleanalytics', $edit, t('Save configuration')); + + // Compare saved setting with posted setting. + $googleanalytics_pages = variable_get('googleanalytics_pages', $this->randomName(8)); + $this->assertEqual('', $googleanalytics_pages, '[testGoogleAnalyticsPhpFilter]: PHP code snippet is intact.'); + + // Check tracking code visibility. + variable_set('googleanalytics_pages', ''); + $this->drupalGet(''); + $this->assertRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPhpFilter]: Tracking is displayed on frontpage page.'); + $this->drupalGet('admin'); + $this->assertRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPhpFilter]: Tracking is displayed on admin page.'); + + variable_set('googleanalytics_pages', ''); + $this->drupalGet(''); + $this->assertNoRaw('https://www.google-analytics.com/analytics.js', '[testGoogleAnalyticsPhpFilter]: Tracking is not displayed on frontpage page.'); + + // Test administration form. + variable_set('googleanalytics_pages', ''); + $this->drupalGet('admin/config/system/googleanalytics'); + $this->assertRaw(t('Pages on which this PHP code returns TRUE (experts only)'), '[testGoogleAnalyticsPhpFilter]: Permission to administer PHP for tracking visibility.'); + $this->assertRaw(check_plain(''), '[testGoogleAnalyticsPhpFilter]: PHP code snippted is displayed.'); + + // Login the delegated user and check if fields are visible. + $this->drupalLogin($this->delegated_admin_user); + $this->drupalGet('admin/config/system/googleanalytics'); + $this->assertNoRaw(t('Pages on which this PHP code returns TRUE (experts only)'), '[testGoogleAnalyticsPhpFilter]: No permission to administer PHP for tracking visibility.'); + $this->assertNoRaw(check_plain(''), '[testGoogleAnalyticsPhpFilter]: No permission to view PHP code snippted.'); + + // Set a different value and verify that this is still the same after the post. + variable_set('googleanalytics_pages', ''); + + $edit = array(); + $edit['googleanalytics_account'] = $ua_code; + $this->drupalPost('admin/config/system/googleanalytics', $edit, t('Save configuration')); + + // Compare saved setting with posted setting. + $googleanalytics_visibility_pages = variable_get('googleanalytics_visibility_pages', 0); + $googleanalytics_pages = variable_get('googleanalytics_pages', $this->randomName(8)); + $this->assertEqual(2, $googleanalytics_visibility_pages, '[testGoogleAnalyticsPhpFilter]: Pages on which this PHP code returns TRUE is selected.'); + $this->assertEqual('', $googleanalytics_pages, '[testGoogleAnalyticsPhpFilter]: PHP code snippet is intact.'); + } + +} diff --git a/googleanalytics.test.js b/googleanalytics.test.js new file mode 100644 index 0000000..f22d6f1 --- /dev/null +++ b/googleanalytics.test.js @@ -0,0 +1,121 @@ +(function ($) { + +/** + * This file is for developers only. + * + * This tests are made for the javascript functions used in GA module. + * These tests verify if the return values are properly working. + * + * Hopefully this can be added somewhere else once Drupal core has JavaScript + * unit testing integrated. + */ + +"use strict"; + +Drupal.googleanalytics.test = {}; + +Drupal.googleanalytics.test.assertSame = function (value1, value2, message) { + if (value1 === value2) { + console.info(message); + } + else { + console.error(message); + } +}; + +Drupal.googleanalytics.test.assertNotSame = function (value1, value2, message) { + if (value1 !== value2) { + console.info(message); + } + else { + console.error(message); + } +}; + +Drupal.googleanalytics.test.assertTrue = function (value1, message) { + if (value1 === true) { + console.info(message); + } + else { + console.error(message); + } +}; + +Drupal.googleanalytics.test.assertFalse = function (value1, message) { + if (value1 === false) { + console.info(message); + } + else { + console.error(message); + } +}; + +// Run after the documented is ready or Drupal.settings is undefined. +$(document).ready(function() { + + /** + * Run javascript tests against the GA module. + */ + + // JavaScript debugging + var base_url = window.location.protocol + '//' + window.location.host; + var base_path = window.location.pathname; + console.dir(Drupal); + + console.group("Test 'isDownload':"); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'node/8'), "Verify that '/node/8' url is not detected as file download."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'files/foo1.zip'), "Verify that '/files/foo1.zip' url is detected as a file download."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'files/foo1.zip#foo'), "Verify that '/files/foo1.zip#foo' url is detected as a file download."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'files/foo1.zip?foo=bar'), "Verify that '/files/foo1.zip?foo=bar' url is detected as a file download."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'files/foo1.zip?foo=bar#foo'), "Verify that '/files/foo1.zip?foo=bar#foo' url is detected as a file download."); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isDownload(base_url + Drupal.settings.basePath + 'files/foo2.ddd'), "Verify that '/files/foo2.ddd' url is not detected as file download."); + console.groupEnd(); + + console.group("Test 'isInternal':"); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternal(base_url + Drupal.settings.basePath + 'node/1'), "Link '" + base_url + Drupal.settings.basePath + "node/2' has been detected as internal link."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternal(base_url + Drupal.settings.basePath + 'node/1#foo'), "Link '" + base_url + Drupal.settings.basePath + "node/1#foo' has been detected as internal link."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternal(base_url + Drupal.settings.basePath + 'node/1?foo=bar'), "Link '" + base_url + Drupal.settings.basePath + "node/1?foo=bar' has been detected as internal link."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternal(base_url + Drupal.settings.basePath + 'node/1?foo=bar#foo'), "Link '" + base_url + Drupal.settings.basePath + "node/1?foo=bar#foo' has been detected as internal link."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternal(base_url + Drupal.settings.basePath + 'go/foo'), "Link '" + base_url + Drupal.settings.basePath + "go/foo' has been detected as internal link."); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isInternal('https://example.com/node/3'), "Link 'https://example.com/node/3' has been detected as external link."); + console.groupEnd(); + + console.group("Test 'isInternalSpecial':"); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isInternalSpecial(base_url + Drupal.settings.basePath + 'go/foo'), "Link '" + base_url + Drupal.settings.basePath + "go/foo' has been detected as special internal link."); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isInternalSpecial(base_url + Drupal.settings.basePath + 'node/1'), "Link '" + base_url + Drupal.settings.basePath + "node/1' has been detected as special internal link."); + console.groupEnd(); + + console.group("Test 'getPageUrl':"); + Drupal.google_analytics.test.assertSame(base_path, Drupal.google_analytics.getPageUrl(window.location.href), "Absolute internal URL '" + base_path + "' has been extracted from full qualified url '" + window.location.href + "'."); + Drupal.google_analytics.test.assertSame(base_path, Drupal.google_analytics.getPageUrl(base_path), "Absolute internal URL '" + base_path + "' has been extracted from absolute url '" + base_path + "'."); + //Drupal.googleanalytics.test.assertSame(base_path, Drupal.googleanalytics.getPageUrl(base_url + Drupal.settings.basePath + 'node/1'), "Absolute internal URL '" + Drupal.settings.basePath + "node/1' has been extracted from full qualified url '" + base_url + base_path + "'."); + //Drupal.googleanalytics.test.assertSame(base_path, Drupal.googleanalytics.getPageUrl(Drupal.settings.basePath + 'node/1'), "Absolute internal URL '" + Drupal.settings.basePath + "node/1' has been extracted from absolute url '" + base_path + "'."); + Drupal.googleanalytics.test.assertSame('https://example.com/node/2', Drupal.googleanalytics.getPageUrl('https://example.com/node/2'), "Full qualified external url 'https://example.com/node/2' has been extracted."); + Drupal.googleanalytics.test.assertSame('//example.com/node/2', Drupal.googleanalytics.getPageUrl('//example.com/node/2'), "Full qualified external url '//example.com/node/2' has been extracted."); + console.groupEnd(); + + console.group("Test 'getDownloadExtension':"); + Drupal.googleanalytics.test.assertSame('zip', Drupal.googleanalytics.getDownloadExtension(base_url + Drupal.settings.basePath + '/files/foo1.zip'), "Download extension 'zip' has been found in '" + base_url + Drupal.settings.basePath + "files/foo1.zip'."); + Drupal.googleanalytics.test.assertSame('zip', Drupal.googleanalytics.getDownloadExtension(base_url + Drupal.settings.basePath + '/files/foo1.zip#foo'), "Download extension 'zip' has been found in '" + base_url + Drupal.settings.basePath + "files/foo1.zip#foo'."); + Drupal.googleanalytics.test.assertSame('zip', Drupal.googleanalytics.getDownloadExtension(base_url + Drupal.settings.basePath + '/files/foo1.zip?foo=bar'), "Download extension 'zip' has been found in '" + base_url + Drupal.settings.basePath + "files/foo1.zip?foo=bar'."); + Drupal.googleanalytics.test.assertSame('zip', Drupal.googleanalytics.getDownloadExtension(base_url + Drupal.settings.basePath + '/files/foo1.zip?foo=bar#foo'), "Download extension 'zip' has been found in '" + base_url + Drupal.settings.basePath + "files/foo1.zip?foo=bar'."); + Drupal.googleanalytics.test.assertSame('', Drupal.googleanalytics.getDownloadExtension(base_url + Drupal.settings.basePath + '/files/foo2.dddd'), "No download extension found in '" + base_url + Drupal.settings.basePath + "files/foo2.dddd'."); + console.groupEnd(); + + // List of top-level domains: example.com, example.net + console.group("Test 'isCrossDomain' (requires cross domain configuration with 'example.com' and 'example.net'):"); + if (Drupal.settings.googleanalytics.trackCrossDomains) { + console.dir(Drupal.settings.googleanalytics.trackCrossDomains); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isCrossDomain('example.com', Drupal.settings.googleanalytics.trackCrossDomains), "URL 'example.com' has been found in cross domain list."); + Drupal.googleanalytics.test.assertTrue(Drupal.googleanalytics.isCrossDomain('example.net', Drupal.settings.googleanalytics.trackCrossDomains), "URL 'example.net' has been found in cross domain list."); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isCrossDomain('www.example.com', Drupal.settings.googleanalytics.trackCrossDomains), "URL 'www.example.com' not found in cross domain list."); + Drupal.googleanalytics.test.assertFalse(Drupal.googleanalytics.isCrossDomain('www.example.net', Drupal.settings.googleanalytics.trackCrossDomains), "URL 'www.example.net' not found in cross domain list."); + } + else { + console.warn('Cross domain tracking is not enabled. Tests skipped.'); + } + console.groupEnd(); + +}); + +})(jQuery); diff --git a/googleanalytics.tokens.inc b/googleanalytics.tokens.inc new file mode 100644 index 0000000..0ab195c --- /dev/null +++ b/googleanalytics.tokens.inc @@ -0,0 +1,55 @@ + t('User role names'), + 'description' => t('The role names the user account is a member of as comma separated list.'), + 'needs-data' => 'user', + ); + $user['role-ids'] = array( + 'name' => t('User role ids'), + 'description' => t('The role ids the user account is a member of as comma separated list.'), + 'needs-data' => 'user', + ); + + return array( + 'tokens' => array('user' => $user), + ); +} + +/** + * Implements hook_tokens(). + */ +function googleanalytics_tokens($type, $tokens, array $data = array(), array $options = array()) { + $sanitize = !empty($options['sanitize']); + $replacements = array(); + + if ($type == 'user' && !empty($data['user']->roles)) { + $account = $data['user']; + + foreach ($tokens as $name => $original) { + switch ($name) { + // Basic user account information. + case 'role-names': + $names = implode(',', $account->roles); + $replacements[$original] = $sanitize ? check_plain($names) : $names; + break; + + case 'role-ids': + $ids = implode(',', array_keys($account->roles)); + $replacements[$original] = $sanitize ? check_plain($ids) : $ids; + break; + } + } + } + + return $replacements; +} diff --git a/googleanalytics.variable.inc b/googleanalytics.variable.inc new file mode 100644 index 0000000..5b88b1f --- /dev/null +++ b/googleanalytics.variable.inc @@ -0,0 +1,55 @@ + 'string', + 'title' => t('Web Property ID', array(), $options), + 'default' => 'UA-', + 'description' => t('This ID is unique to each site you want to track separately, and is in the form of UA-xxxxxxx-yy. To get a Web Property ID, register your site with Google Analytics, or if you already have registered your site, go to your Google Analytics Settings page to see the ID next to every site profile. Find more information in the documentation.', array('@analytics' => 'https://marketingplatform.google.com/about/analytics/', '@webpropertyid' => url('https://developers.google.com/analytics/resources/concepts/gaConceptsAccounts', array('fragment' => 'webProperty'))), $options), + 'required' => TRUE, + 'group' => 'googleanalytics', + 'localize' => TRUE, + 'multidomain' => TRUE, + 'validate callback' => 'googleanalytics_validate_googleanalytics_account', + ); + + return $variables; +} + +/** + * Implements hook_variable_group_info(). + */ +function googleanalytics_variable_group_info() { + $groups['googleanalytics'] = array( + 'title' => t('Google Analytics'), + 'description' => t('Configure tracking behavior to get insights into your website traffic and marketing effectiveness.'), + 'access' => 'administer google analytics', + 'path' => array('admin/config/system/googleanalytics'), + ); + + return $groups; +} + +/** + * Validate Web Property ID variable. + * + * @param array $variable + * + * @return string + */ +function googleanalytics_validate_googleanalytics_account($variable) { + // Replace all type of dashes (n-dash, m-dash, minus) with the normal dashes. + $variable['value'] = str_replace(array('–', '—', '−'), '-', $variable['value']); + + if (!preg_match('/^UA-\d+-\d+$/', $variable['value'])) { + return t('A valid Google Analytics Web Property ID is case sensitive and formatted like UA-xxxxxxx-yy.'); + } +}