Skip to content

Commit 5f7a57b

Browse files
committed
added readme file
1 parent f7048bf commit 5f7a57b

1 file changed

Lines changed: 100 additions & 0 deletions

File tree

readme.txt

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
=== CBX Search Tracker ===
2+
Contributors: codeboxr
3+
Tags: search, search analytics, keyword tracker, search tracker, admin dashboard
4+
Requires at least: 5.8
5+
Tested up to: 6.5
6+
Requires PHP: 7.4
7+
Stable tag: 1.1.0
8+
License: GPLv2 or later
9+
License URI: https://www.gnu.org/licenses/gpl-2.0.html
10+
Text Domain: cbxsearchtracker
11+
12+
Track WordPress search keywords and display the most searched keywords in a simple admin dashboard.
13+
14+
== Description ==
15+
16+
CBX Search Tracker records every keyword searched on your WordPress site and keeps track of how many times each keyword has been searched.
17+
18+
It provides a clean admin dashboard page where you can view the most searched keywords, along with search count and last searched date.
19+
20+
Perfect for:
21+
22+
* Understanding user intent
23+
* Discovering popular topics
24+
* Identifying content gaps
25+
* Improving SEO strategy
26+
* Building data-driven content
27+
28+
== Features ==
29+
30+
* Automatically tracks all WordPress search queries
31+
* Stores search count per keyword
32+
* Normalizes keywords (lowercase + trimmed)
33+
* Displays top 100 searched keywords
34+
* Shows last searched date
35+
* Delete individual keywords from dashboard
36+
* Secure admin actions (nonce protected)
37+
* Translation ready
38+
* Lightweight and database-efficient
39+
40+
== Installation ==
41+
42+
1. Upload the plugin folder to `/wp-content/plugins/`
43+
2. Activate the plugin through the 'Plugins' menu in WordPress
44+
3. Go to **Search Tracker** in the WordPress admin menu
45+
4. Start analyzing your search data
46+
47+
== Frequently Asked Questions ==
48+
49+
= Does this track admin searches? =
50+
51+
No. Only frontend searches are tracked.
52+
53+
= Does this affect performance? =
54+
55+
No noticeable impact. It performs a single lightweight database query per search.
56+
57+
= Can I delete keywords? =
58+
59+
Yes. Each keyword can be deleted individually from the dashboard.
60+
61+
= Is it translation ready? =
62+
63+
Yes. The plugin uses the text domain `cbxsearchtracker`.
64+
65+
= Does it track zero-result searches? =
66+
67+
Currently it tracks all searches. Zero-result filtering can be added in a future version.
68+
69+
== Screenshots ==
70+
71+
1. Admin dashboard showing most searched keywords
72+
2. Delete keyword action
73+
3. Empty state when no searches recorded
74+
75+
== Changelog ==
76+
77+
= 1.1.0 =
78+
* Added translation support
79+
* Added delete keyword option
80+
* Added nonce verification for security
81+
* Improved keyword normalization
82+
83+
= 1.0.0 =
84+
* Initial release
85+
* Tracks search keywords
86+
* Admin dashboard listing
87+
88+
== Upgrade Notice ==
89+
90+
= 1.1.0 =
91+
Improved security and added delete functionality.
92+
93+
== Support ==
94+
95+
For support, feature requests, or bug reports:
96+
https://codeboxr.com/
97+
98+
== Privacy ==
99+
100+
This plugin stores search keywords in your WordPress database. It does not send any data to external services.

0 commit comments

Comments
 (0)