\n<\/h2>\n
\n ![\"settings\"](\"\/data\/content\/doc\/wordpress\/downloads-stats\/getting-started-dlstat\/settings-en.png\" "\\"settings")
\n<\/p>\n
\n General
\n<\/h3>\n\n- Relative site path<\/strong>\n
\n- <\/a>Enable<\/strong>\n
\n It is useful to disable item without deleting the configuration.\n <\/p>\n<\/li>\n
- <\/a>Use event label<\/strong>\n
\n Use statistics event label for that path. Doesn\u2019t work if common statistics event label<\/a> is disabled.<\/strong>\n <\/p>\n<\/li>\n- <\/a>Path<\/strong>\n
\n Type relative site\u2019s path to monitor it\u2019s files downloads.\n <\/p>\n
Note:<\/strong> Choose path more precisely. Otherwise, it might degrade performance of downloading site’s elements.\n <\/p>\n<\/li>\n- <\/a>Files types<\/strong>\n
\n List of comma separated files extensions that only be included in monitor.\n <\/p>\n
Note:<\/strong> There are system file types that always excluded from monitoring to prevent unstable site work: *.htaccess, *.php, *.js and *.css.\n <\/p>\n<\/li>\n<\/ul>\n<\/li>\n- <\/a>Statistics event label<\/strong>\n
\n It is possible to use URL\u2019s arguments as a statistics label. Label will be formed from a list of request’s arguments using the argument separator and the value delimiter.\n <\/p>\n
\n- Enable<\/strong>\n
\n Check to use it in all paths. Each path can enable it separately<\/a>.\n <\/p>\n<\/li>\n- Argument separator<\/strong>\n
\n Separator between arguments.\n <\/p>\n<\/li>\n
- Argument value delimiter<\/strong>\n
\n Separator between argument\u2019s name and value.\n <\/p>\n<\/li>\n<\/ul>\n
\n So e.g. for URL \u2018http:\/\/yoursite.com\/page?arg1=v1&arg2=v1\u2019 in case of \u2018Argument separator\u2019 = \u2018,\u2019 and \u2018Argument value delimiter\u2019 = \u2018:\u2019 label will be ‘arg1:v1,arg2:v2’.\n <\/p>\n<\/li>\n
- <\/a>Send mode<\/strong>\n
\n By default statistic sending each minute to provide data on the time.\n <\/p>\n
Note:<\/strong> There is the alternative way<\/a> how to setup WP Cron on your site.\n <\/p>\n<\/li>\n<\/ul>\n<\/a>Google Analytics
\n<\/h3>\n\n If enabled, statistics will be sent to Google Analytics account by specified tracking ID as events with specified event category, URI as event action and URL arguments as event label if it is enabled in general settings<\/a>.\n<\/p>\n\n- <\/a>Enable<\/strong>\n
\n Set this checkbox to enable statistics sending.\n <\/p>\n<\/li>\n
- <\/a>Tracking ID<\/strong>\n
\n Tracking ID of the account. Type your Google Analytics\u2019s tracking ID.\n <\/p>\n<\/li>\n
- <\/a>Event category<\/strong>\n
\n Event category that will be seen in the events’ dashboard. Change event category if needed.\n <\/p>\n<\/li>\n
- <\/a>Custom dimension for client ID<\/strong>\n
\n Custom dimension index to store client ID for debug purposes e.g. user’s IP. Optional.\n <\/p>\n<\/li>\n<\/ul>\n
<\/a>Local Database
\n<\/h3>\n\n If enabled, statistics will be written to the local database table with name \u2018wp_seraph_dlstat\u2019. Use any databese viewer or editor to see events. It is used generally for debug purposes only or if there is no any other way.\n<\/p>\n
\n- <\/a>Enable<\/strong>\n
\n Set this checkbox to enable statistics writing.\n <\/p>\n<\/li>\n
- <\/a>Data<\/strong>\n
\n Set this checkbox and all data will be erased. If \u2018Enabled\u2019 is unchecked \u2018wp_seraph_dlstat\u2019 table will be deleted as well.\n <\/p>\n<\/li>\n<\/ul>\n
\n Configuration under NGINX
\n<\/h2>\n
\n To enable working under NGINX<\/strong> the following directives should be added manually into the begin of server<\/code> directive:\n<\/p>\n# seraphinite-downloads-stats - File hook redirection
include \/www\/wwwroot\/my-site.com\/seraph-dlstat.conf;<\/code>\n<\/p>\n\n And the \/www\/wwwroot\/my-site.com<\/code> should be replaced by your site\u2019s root filesystem path.\n<\/p>\nNote<\/strong>. <\/span>After changing the settings, you need to manually update the <\/span>NGINX configuration.\n<\/p>\n<\/a>API
\n<\/h2>\n\n There are a set of filters and actions to hook.\n<\/p>\n
seraph_dlstat_prepare_events<\/strong> filter\n<\/p>\nseraph_dlstat_event_label_format<\/strong> filter\n<\/p>\nseraph_dlstat_items_download_requested<\/strong> action\n<\/p>\nseraph_dlstat_ga_prepare_event<\/strong> filter\n<\/p>\n<\/a>Requirements
\n<\/h2>\n\n
- WordPress<\/a> 4.5 or higher.<\/li>
- PHP 5.4 or higher.<\/li>
- Apache Web Server<\/a> 2.0 or higher (for site\u2019s .htaccess file).<\/li>
- Browser (Google Chrome, Firefox, IE).<\/li><\/ul><\/p>\n","protected":false},"excerpt":{"rendered":"
The plugin allows track files downloads in specific site\u2019s relative path by sending statistics to Google Analytics and the Local Database. Settings General Relative site path Enable It is useful to disable item without deleting the configuration. Use event label Use statistics event label for that path. Doesn\u2019t work if common statistics event label is…<\/p>\n","protected":false},"author":18,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"rank_math_lock_modified_date":false},"categories":[150],"tags":[],"class_list":["post-1183","doc","type-doc","status-publish","hentry","category-downloads-stats"],"_links":{"self":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/doc\/1183","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/types\/doc"}],"author":[{"embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/comments?post=1183"}],"wp:attachment":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/media?parent=1183"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/categories?post=1183"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/tags?post=1183"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- \n
- <\/a>Enable<\/strong>\n
\n It is useful to disable item without deleting the configuration.\n <\/p>\n<\/li>\n
- <\/a>Use event label<\/strong>\n
\n Use statistics event label for that path. Doesn\u2019t work if common statistics event label<\/a> is disabled.<\/strong>\n <\/p>\n<\/li>\n
- <\/a>Path<\/strong>\n
\n Type relative site\u2019s path to monitor it\u2019s files downloads.\n <\/p>\n
Note:<\/strong> Choose path more precisely. Otherwise, it might degrade performance of downloading site’s elements.\n <\/p>\n<\/li>\n
- <\/a>Files types<\/strong>\n
\n List of comma separated files extensions that only be included in monitor.\n <\/p>\n
Note:<\/strong> There are system file types that always excluded from monitoring to prevent unstable site work: *.htaccess, *.php, *.js and *.css.\n <\/p>\n<\/li>\n<\/ul>\n<\/li>\n
- <\/a>Statistics event label<\/strong>\n
\n It is possible to use URL\u2019s arguments as a statistics label. Label will be formed from a list of request’s arguments using the argument separator and the value delimiter.\n <\/p>\n
- \n
- Enable<\/strong>\n
\n Check to use it in all paths. Each path can enable it separately<\/a>.\n <\/p>\n<\/li>\n
- Argument separator<\/strong>\n
\n Separator between arguments.\n <\/p>\n<\/li>\n
- Argument value delimiter<\/strong>\n
\n Separator between argument\u2019s name and value.\n <\/p>\n<\/li>\n<\/ul>\n
\n So e.g. for URL \u2018http:\/\/yoursite.com\/page?arg1=v1&arg2=v1\u2019 in case of \u2018Argument separator\u2019 = \u2018,\u2019 and \u2018Argument value delimiter\u2019 = \u2018:\u2019 label will be ‘arg1:v1,arg2:v2’.\n <\/p>\n<\/li>\n
- <\/a>Send mode<\/strong>\n
\n By default statistic sending each minute to provide data on the time.\n <\/p>\n
Note:<\/strong> There is the alternative way<\/a> how to setup WP Cron on your site.\n <\/p>\n<\/li>\n<\/ul>\n
<\/a>Google Analytics
\n<\/h3>\n\n If enabled, statistics will be sent to Google Analytics account by specified tracking ID as events with specified event category, URI as event action and URL arguments as event label if it is enabled in general settings<\/a>.\n<\/p>\n
- \n
- <\/a>Enable<\/strong>\n
\n Set this checkbox to enable statistics sending.\n <\/p>\n<\/li>\n
- <\/a>Tracking ID<\/strong>\n
\n Tracking ID of the account. Type your Google Analytics\u2019s tracking ID.\n <\/p>\n<\/li>\n
- <\/a>Event category<\/strong>\n
\n Event category that will be seen in the events’ dashboard. Change event category if needed.\n <\/p>\n<\/li>\n
- <\/a>Custom dimension for client ID<\/strong>\n
\n Custom dimension index to store client ID for debug purposes e.g. user’s IP. Optional.\n <\/p>\n<\/li>\n<\/ul>\n
<\/a>Local Database
\n<\/h3>\n\n If enabled, statistics will be written to the local database table with name \u2018wp_seraph_dlstat\u2019. Use any databese viewer or editor to see events. It is used generally for debug purposes only or if there is no any other way.\n<\/p>\n
- \n
- <\/a>Enable<\/strong>\n
\n Set this checkbox to enable statistics writing.\n <\/p>\n<\/li>\n
- <\/a>Data<\/strong>\n
\n Set this checkbox and all data will be erased. If \u2018Enabled\u2019 is unchecked \u2018wp_seraph_dlstat\u2019 table will be deleted as well.\n <\/p>\n<\/li>\n<\/ul>\n
\n Configuration under NGINX
\n<\/h2>\n\n To enable working under NGINX<\/strong> the following directives should be added manually into the begin of
server<\/code> directive:\n<\/p>\n# seraphinite-downloads-stats - File hook redirection
include \/www\/wwwroot\/my-site.com\/seraph-dlstat.conf;<\/code>\n<\/p>\n\n And the
\/www\/wwwroot\/my-site.com<\/code> should be replaced by your site\u2019s root filesystem path.\n<\/p>\nNote<\/strong>. <\/span>After changing the settings, you need to manually update the <\/span>NGINX configuration.\n<\/p>\n
<\/a>API
\n<\/h2>\n\n There are a set of filters and actions to hook.\n<\/p>\n
seraph_dlstat_prepare_events<\/strong> filter\n<\/p>\n
seraph_dlstat_event_label_format<\/strong> filter\n<\/p>\n
seraph_dlstat_items_download_requested<\/strong> action\n<\/p>\n
seraph_dlstat_ga_prepare_event<\/strong> filter\n<\/p>\n
<\/a>Requirements
\n<\/h2>\n\n
- WordPress<\/a> 4.5 or higher.<\/li>
- PHP 5.4 or higher.<\/li>
- Apache Web Server<\/a> 2.0 or higher (for site\u2019s .htaccess file).<\/li>
- Browser (Google Chrome, Firefox, IE).<\/li><\/ul><\/p>\n","protected":false},"excerpt":{"rendered":"
The plugin allows track files downloads in specific site\u2019s relative path by sending statistics to Google Analytics and the Local Database. Settings General Relative site path Enable It is useful to disable item without deleting the configuration. Use event label Use statistics event label for that path. Doesn\u2019t work if common statistics event label is…<\/p>\n","protected":false},"author":18,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"rank_math_lock_modified_date":false},"categories":[150],"tags":[],"class_list":["post-1183","doc","type-doc","status-publish","hentry","category-downloads-stats"],"_links":{"self":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/doc\/1183","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/doc"}],"about":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/types\/doc"}],"author":[{"embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/users\/18"}],"replies":[{"embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/comments?post=1183"}],"wp:attachment":[{"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/media?parent=1183"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/categories?post=1183"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.s-sols.com\/api\/wp\/v2\/tags?post=1183"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- <\/a>Data<\/strong>\n
- <\/a>Tracking ID<\/strong>\n
- Argument separator<\/strong>\n
- <\/a>Use event label<\/strong>\n