Title: McAvoy Author: Steve Grunwell Published: Meurth 28, 2016 Last modified: Ebrel 27, 2016 --- Search plugins ![](https://ps.w.org/mcavoy/assets/banner-772x250.png?rev=1380440) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/mcavoy/assets/icon-256x256.png?rev=1380440) # McAvoy By [Steve Grunwell](https://profiles.wordpress.org/stevegrunwell/) [Download](https://downloads.wordpress.org/plugin/mcavoy.0.1.3.zip) * [Details](https://cor.wordpress.org/plugins/mcavoy/#description) * [Reviews](https://cor.wordpress.org/plugins/mcavoy/#reviews) * [Installation](https://cor.wordpress.org/plugins/mcavoy/#installation) * [Development](https://cor.wordpress.org/plugins/mcavoy/#developers) [Support](https://wordpress.org/support/plugin/mcavoy/) ## Description McAvoy is a simple WordPress that logs site searches (and information about the people performing them) so you can get a better sense of what your audience is looking for. Is your navigation unclear? Are people regularly getting lost in your infinitely- scrolling homepage when they’re just trying to find the latest news on a topic? McAvoy is there, collecting the facts you need to make informed decisions! Best of all, McAvoy is meant to grow with you, sending search query data anywhere you need to in order to get the most meaningful results. **Notice:** In the interest of writing the best software possible, McAvoy requires a _minimum_ of PHP 5.3. For more information, please see the Frequently Asked Questions. To keep up with the latest developments (or to contribute to ongoing development), please [keep up with McAvoy on GitHub](https://github.com/stevegrunwell/mcavoy)! ## Screenshots * [[ * A list of recent searches made on a site – judging by the terms, it sounds like someone was hungry! ## Installation 1. Upload the plugin files to `/wp-content/plugins/mcavoy` or install the plugin through the WordPress plugins screen directly. 2. Activate the plugin through the ‘Plugins’ screen in WordPress. ## FAQ #### Eww, this plugin adds a new database table? Can’t I put the data somewhere else? Absolutely! Creating a new database table isn’t ideal in a lot of situations, so McAvoy has been built from the ground-up to be flexible in the way the data is handled. For example, if you want to send the data to something like [Firebase](https://www.firebase.com/), you can easily do so by creating a new callback attached to the `mcavoy_save_search_query` action: ``` /** * Save a search query to Firebase. * * @param string $term The search term. * @param array $metadata Meta data that should be saved with the query. */ function save_search_query_to_firebase( $term, $metadata ) { // do something with this data! } add_action( 'mcavoy_save_search_query', 'save_search_query_to_firebase', 10, 2 ); ``` #### What’s all this about requiring at least PHP 5.3? McAvoy has been written using [PHP Namespaces](http://php.net/manual/en/language.namespaces.php), which is super common in the larger PHP community but rather rare in WordPress ( as WordPress strives to support as many people as possible). For most users, this minimum requirement shouldn’t be of any concern (after all, [security patches stopped being delivered for PHP 5.3 in mid-2014](http://php.net/supported-versions.php)). If you **are** affected, however, I urge you to _please_ upgrade your server (or change hosts) as soon as humanely possible. Besides the obvious benefits of having current security patches, newer versions of PHP are more performant than ever. #### Who the heck is McAvoy? This plugin was designed to answer five questions about your site’s audience, specifically those searching on it: “who”, “what”, “when”, “where”, and “why.” Those even somewhat familiar with journalism probably recognize the importance of those five questions, and as such I found it fitting to name the plugin after a journalist. [Edward R Murrow](https://en.wikipedia.org/wiki/Edward_R._Murrow), [Walter Cronkite](https://en.wikipedia.org/wiki/Walter_Cronkite), and [Dan Rather](https://en.wikipedia.org/wiki/Dan_Rather) were all contenders, but ultimately [ACN Anchor Will McAvoy](https://en.wikipedia.org/wiki/The_Newsroom_(U.S._TV_series)) won out. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “McAvoy” is open source software. The following people have contributed to this plugin. Contributors * [ Steve Grunwell ](https://profiles.wordpress.org/stevegrunwell/) [Translate “McAvoy” into your language.](https://translate.wordpress.org/projects/wp-plugins/mcavoy) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/mcavoy/), check out the [SVN repository](https://plugins.svn.wordpress.org/mcavoy/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/mcavoy/) by [RSS](https://plugins.trac.wordpress.org/log/mcavoy/?limit=100&mode=stop_on_copy&format=rss). ## Changelog For a complete changelog, please see [McAvoy’s GitHub repository](https://github.com/stevegrunwell/mcavoy/blob/master/CHANGELOG.md). #### 0.1.3 * Fixed the `mcavoy_searches` table schema to accommodate more searches. #### 0.1.2 * Fixed issue with WordPress Multisite wherein McAvoy would not properly set up the `DatabaseLogger` dependencies when network activated. #### 0.1.1 * Fixed cross-site scripting (XSS) bug where search terms weren’t automatically escaped. * Fixed fatal error (`Fatal error: Call to undefined function McAvoy\Admin\get_logger()`) when deleting saved queries that resulted as a side-effect of namespace juggling. * Added method access modifiers to the `ListTable` class. #### 0.1.0 * Initial public release. ## Meta * Version **0.1.3** * Last updated **10 years ago** * Active installations **10+** * WordPress version ** 4.4 or higher ** * Tested up to **4.5.33** * Language * [English (US)](https://wordpress.org/plugins/mcavoy/) * Tags * [query](https://cor.wordpress.org/plugins/tags/query/)[search](https://cor.wordpress.org/plugins/tags/search/) [site search](https://cor.wordpress.org/plugins/tags/site-search/)[tracking](https://cor.wordpress.org/plugins/tags/tracking/) * [Advanced View](https://cor.wordpress.org/plugins/mcavoy/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/mcavoy/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/mcavoy/reviews/) ## Contributors * [ Steve Grunwell ](https://profiles.wordpress.org/stevegrunwell/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/mcavoy/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://stevegrunwell.com/donate)