forked from algolia/algoliasearch-wordpress
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
252 lines (170 loc) · 12.2 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
=== Search by Algolia – Instant & Relevant results ===
Contributors: algolia, rayrutjes
Tags: Search, Algolia, Autocomplete, instant-search, relevant search, search highlight, faceted search, find-as-you-type search, suggest, search by category, ajax search, better search, custom search
Requires at least: 4.4
Tested up to: 4.7
Stable tag: 2.2.3
License: MIT License, GNU General Public License v2.0
Search by Algolia is the smartest way to improve search on your site. Autocomplete is included, along with full control over look, feel and relevance.
== Description ==
The plugin provides relevant search results in milliseconds, ensuring that your users can find your best posts at the speed of thought. It also comes with native typo-tolerance and is language-agnostic, so that every WordPress user, no matter where they are, can benefit from it.
= About pricing =
This plugin relies on the [Algolia service](https://www.algolia.com/) which requires you to [create an account here](https://www.algolia.com/users/sign_up).
Algolia offers its Search as a Service provider on a incremental payment program, including a free Hacker Plan which includes 10,000 records & 100,000 operations per month. Beyond that, plans start at $49/month.
Note that there isn’t a direct correlation between the number of posts in WordPress and the number of records in Algolia.
Also note that we only offer support to paying plans.
On average, you can expect to have about 10 times more records than you have posts, though this is not a golden rule and you could end up with more records.
= Getting started guide =
Once you have installed the plugin, you can follow the step by step guide provided here: https://community.algolia.com/wordpress/configuration.html
= Relevance =
Algolia enhances your search functionality with a completely customizable search experience which can be seamlessly integrated into your Wordpress theme. It lets you create a find-as-you-type experience or an auto-complete dropdown menu, which provides relevant results from the first keystroke. Our extension also automatically synchronizes data (posts, taxonomies etc.) in real-time, making sure that any updates to your site are available as soon as they are made.
= Speed =
Algolia returns results in under 35ms on an average – irrespective of whether you have 100s or 1000s of posts.
Our state-of-the-art infrastructure and distributed search network ensures that your readers benefit from this, no matter where they are.
= Accessibility =
Search by Algolia gives you the ability to make all forms of data – blog posts, categories, users etc. – searchable from a single search bar. Algolia also gives you the ability to completely customize your search results based on criteria that makes sense for your business, such as popularity, date, relevance etc.
= Built by developers for developers =
Search by Algolia is also completely configurable and fully extensible by means of WordPress filters and hooks, letting you build a custom search experience or theme based on Algolia.
Want to see out how we did it?
Check it out here: [Search by Algolia GitHub Repository](https://github.com/algolia/algoliasearch-wordpress)
Join the Algolia community and meet thousands of search enthusiasts. We’re also always on the lookout for feedback: https://community.algolia.com/wordpress
== Frequently Asked Questions ==
= Where can I find Search by Algolia documentation and user guides? =
- For help setting up and configuring Search by Algolia please refer to our [user guide](https://community.algolia.com/wordpress/installation.html)
- For extending or theming the Autocomplete dropdown, see our [Autocomplete Customization guide](https://community.algolia.com/wordpress/customize-autocomplete.html).
- For extending or theming the Instant Search results page, see our [Search Page Customization guide](https://community.algolia.com/wordpress/customize-search-page.html).
= Will Search by Algolia work with my theme? =
Yes; Search by Algolia will work with any theme, but the Instant Search results page may require some styling to make it match nicely.
= Where can I report bugs or contribute to the project? =
Bugs can be reported either in our support forum or preferably on the [Search by Algolia GitHub repository](https://github.com/algolia/algoliasearch-wordpress).
= My issue is not listed here, what should I do? =
Please check out the [Frequently Asked Questions](https://community.algolia.com/wordpress/frequently-asked-questions.html) on our website which might have more information than this thread.
It will also give you guidance about where to ask support if your question is not covered.
== Installation ==
= Minimum Requirements =
* PHP version 5.3 or greater (PHP 5.6 or greater is recommended)
* MySQL version 5.0 or greater (MySQL 5.6 or greater is recommended)
* Some payment gateways require fsockopen support (for IPN access)
* Requires WordPress 3.7+ (WordPress 4.4+ is recommended because we will drop support below it in upcoming releases)
Visit the [Search by Algolia server requirements documentation](https://community.algolia.com/wordpress/installation.html) for a detailed list of server requirements.
= Automatic installation =
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of Search by Algolia, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.
In the search field type “Algolia” and click Search Plugins. Once you’ve found our search plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.
= Manual installation =
The manual installation method involves downloading our search plugin and uploading it to your webserver via your favourite FTP application. The WordPress codex contains [instructions on how to do this here](https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).
= Updating =
Automatic updates should work like a charm; as always though, ensure you backup your site just in case.
== Screenshots ==
1. Algolia Settings.
2. Indexing configuration.
3. Instant-search results configuration.
4. Autocomplete dropdown configuration.
5. Autocomplete dropdown example.
6. Instant-search results page example.
== Changelog ==
= 2.2.3 =
- Fallback to native search if Algolia call fails on search page
- Avoid displaying fatal error when failing to reach Algolia in the admin
= 2.2.2 =
- Correctly position autocomplete dropdown when located inside a fixed container
= 2.2.1 =
- Rename 'page' variable to 'p' for ajax calls to avoid certain conflicts
- Move CSS and JS files out of assets/ directory to prepare for publishing all tags
- Avoid conflict with Polylang plugin
= 2.2.0 =
- Ensure frontend dependencies are loaded (especially 'wp-util': wp.template())
- Escape ET Divi builder shortcodes
- Force autocomplete dropdown to be displayed above everything else
= 2.1.0 =
- Introduce a new filter to allow to customize synced indices
= 2.0.1 =
- Fix an error that would display PHP notices on search results pages
= 2.0.0 =
To upgrade from 1.7.0, follow the [Upgrade instructions](https://community.algolia.com/wordpress/upgrade.html#from-1-7-0-to-2-0-0).
**New features**
- Allow to re-order results by drag and drop from the autocomplete settings page
- Allow to customize the header label of each result type of the autocomplete dropdown menu
- Allow to disable powered by logo from the admin
- Allow to re-index every index separatly
- Keep existing index settings when re-indexing
- Keep existing synonyms when re-indexing
- Add a filter hook to specify the thumbnail formats to send to Algolia
- Use new Algolia logo
- Backend is now powered by Algolia when instantsearch.js is enabled in the frontend
- New splitting strategy resulting in better relevancy and snippets
- Add an "no results" template to the autocomplete dropdown
**Enhancements & bug fixes**
- Remove custom post type algolia_task
- Remove custom post type algolia_log
- Do not rely on wp_footer begin called in themes
- Bump number of items to index per batch up to 100
- Updated JS dependencies
- Update Algolia API Client
- Remove local queue in favor of in browser queue
- Remove the Algolia logger
- Removed title 1-6 from records
- Reduced the default size of json payloads
- Push correct thumbnail URLs for attachments
- Protect autocomplete and instantsearch from XSS
- Remove outdated polyfills for empty search queries
- Removed tether for autocomplete dropdown placement
- Resolved conflict with Jetpack plugin
- Resolved conflict with Toolset plugin
- Fixed an issue were autocomplete settings needed to be saved again
- The plugin does not push all image sizes anymore
= 1.7.0 =
To upgrade from 1.6.0, follow the [Upgrade instructions](https://community.algolia.com/wordpress/upgrade.html#from-1-6-0-to-1-7-0).
* Fix the condition to remove the powered by
* Use autocomplete.js in noConflict mode
* Also append Cookies to wp_remote_post test calls on indexing screen
* Update WordPress tested up to 4.7
* Ensure wp-util is always loaded before instantsearch.js or autocomplete.js
* Enable Yoast frontend hooks when indexing records
* Check if the API is reachable before executing CLI commands
= 1.6.0 =
* Re-index indices instead of moving them when index name prefix is changed
* Keep the synonyms configured on the Algolia dashboard when we re-index
* Add a command to the WP-CLI integration to re-index a single index
* Allow API Keys and index name prefix to be configured with constants to ease switching between environments
= 1.5.0 =
* Split content attribute over several records if greater than 5000 bytes
* Support changing prefix on indices having replicas
* Add a constant to disable post splitting
* Fix an issue where the index name would rely on a non existing 'label' key of the post type object
* Replace Visual Composer shortcodes in posts
= 1.4.1 =
* Fix the validity check for the Admin API key in the settings tab
= 1.4.0 =
* Introduce the `algolia_loopback_request_args` filter to override loopback args. Allows queue to work with Basic Authentication
* Allow user generated Admin API keys
* Resolve logging performances causing queue to crash before being able to move _tmp indices to their final destination
* Make sure "shortcodes" are parsed inside post excerpts
* Add support for non UTF-8 content
* Display a more explicit error when credential validation fails
* Add a filter `algolia_search_params` to be able to filter backend search parameters
= 1.3.0 =
* Make the plugin play nicely with the W3 Total Cache plugin
* Fix an issue where the Cache Enabler plugin would break the autocomplete when JavaScript was inlined
* Introduced a constant to hide admin help notices
* Add WP CLI process-queue & re-index-all commands
* Allow theme authors to get full control over the Algolia templates location
* Stop the queue instead of trashing failed tasks
* Allow users to delete all pending tasks
* Allow users to stop the queue when it is running
= 1.2.0 =
* Fix broken pagination on instant search page
* Fix conflicts with plugins also using the PHP `simple_html_dom` library
* Limit the maximum number of log entries to 50 by default
* Fix an issue where empty errors would get logged during queue processing
* Introduce class `.no-autocomplete` to disable autocomplete on search inputs
* Add support for a new constant `ALGOLIA_LOOPBACK_HTTP` that allows forcing HTTP in queue loopback
You can access older changes [here](https://github.com/algolia/algoliasearch-wordpress/blob/master/CHANGELOG.md)
== Upgrade Notice ==
= 1.3.0 =
We fixed some issues in the `templates/autocomplete.php` and `templates/instantsearch.php` files.
If you have copied the templates folder in your theme folder, you should make sure you manually patch the following fixes:
- https://github.com/algolia/algoliasearch-wordpress/commit/81ce6975ad1069d8db95cdb92cbd60e139328465
= 1.2.0 =
We fixed some issues in the `templates/autocomplete.php` and `templates/instantsearch.php` files.
If you have copied the templates folder in your theme folder, you should make sure you manually patch the following fixes:
- https://github.com/algolia/algoliasearch-wordpress/pull/305