algoliasearch.zendesk-hc 2.30.0 → 2.31.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -12
- package/dist/algoliasearch.zendesk-hc.css +2 -2
- package/dist/algoliasearch.zendesk-hc.js +20 -20
- package/dist/algoliasearch.zendesk-hc.min.css +2 -2
- package/dist/algoliasearch.zendesk-hc.min.js +18 -18
- package/dist/algoliasearch.zendesk-hc.min.js.map +1 -1
- package/dist-es5-module/index.js +3 -2
- package/dist-es5-module/src/AlgoliasearchZendeskHC.js +43 -20
- package/dist-es5-module/src/autocomplete.js +25 -15
- package/dist-es5-module/src/clickAnalytics.js +8 -3
- package/dist-es5-module/src/getCurrentLocale.js +1 -1
- package/dist-es5-module/src/index.js +1 -1
- package/dist-es5-module/src/instantsearch.js +22 -12
- package/dist-es5-module/src/stopwords/uk.js +1 -1
- package/dist-es5-module/src/stopwords.js +37 -39
- package/dist-es5-module/src/templates.js +2 -4
- package/dist-es5-module/src/translations.js +3 -2
- package/package.json +15 -8
package/README.md
CHANGED
|
@@ -1,11 +1,6 @@
|
|
|
1
1
|
# JavaScript library: `algoliasearchZendeskHC`
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/algoliasearch.zendesk-hc)
|
|
4
|
-
|
|
5
|
-
[](https://david-dm.org/algolia/algoliasearch-zendesk?path=app)
|
|
6
|
-
[](https://david-dm.org/algolia/algoliasearch-zendesk?path=app#info=devDependencies)
|
|
7
|
-
[](https://david-dm.org/algolia/algoliasearch-zendesk?path=app#info=peerDependencies)
|
|
8
|
-
|
|
9
4
|
[](../LICENSE)
|
|
10
5
|
|
|
11
6
|
This JavaScript library allows you to replace the default search of your Zendesk Help Center by Algolia. [Algolia](https://www.algolia.com) is a hosted full-text, numerical, and faceted search engine capable of delivering realtime results from the first keystroke.
|
|
@@ -22,7 +17,7 @@ To browse through the crawler, visit the [crawler/](../crawler/) folder.
|
|
|
22
17
|
### Synchronize Algolia with your Help Center
|
|
23
18
|
|
|
24
19
|
<div align="center">
|
|
25
|
-
<img src="https://
|
|
20
|
+
<img src="https://www.algolia.com/_next/image/?url=https%3A%2F%2Fres.cloudinary.com%2Fhilnmyskv%2Fimage%2Fupload%2Fv1671027406%2FAlgolia_com_Website_assets%2Fimages%2Fzendesk%2FZendesk-algolia.png&w=1200&q=75" alt="Data connection visualization" />
|
|
26
21
|
</div>
|
|
27
22
|
|
|
28
23
|
1. Create an [Algolia account](https://www.algolia.com/users/sign_up).
|
|
@@ -36,8 +31,8 @@ You can access it with the left sidebar in your dashboard.
|
|
|
36
31
|
This connector will every day take your public Help Center articles and put them inside an Algolia index.
|
|
37
32
|
In most cases, this should be enough to have an up-to-date search.
|
|
38
33
|
|
|
39
|
-
However, if you'd rather have it updated
|
|
40
|
-
On
|
|
34
|
+
However, if you'd rather have it updated sooner, you can manually trigger a full reindex.
|
|
35
|
+
On your [Connectors](https://dashboard.algolia.com/connectors/tasks) page, click the "Run task" button on the right of your task.
|
|
41
36
|
|
|
42
37
|
### Updating your Help Center theme
|
|
43
38
|
|
|
@@ -76,11 +71,11 @@ Here is a full breakdown of the available options for the JavaScript library:
|
|
|
76
71
|
applicationId: '<YOUR APPLICATION_ID>',
|
|
77
72
|
apiKey: '<YOUR SEARCH ONLY API KEY>',
|
|
78
73
|
subdomain: '<YOUR ZENDESK APPLICATION NAME>',
|
|
74
|
+
indexName: '<YOUR ALGOLIA INDEX NAME>',
|
|
79
75
|
|
|
80
76
|
//
|
|
81
77
|
// Optional configuration:
|
|
82
78
|
//
|
|
83
|
-
indexPrefix: 'zendesk_', // or your custom <INDEX_PREFIX>
|
|
84
79
|
analytics: true, // should queries be processed by Algolia analytics
|
|
85
80
|
baseUrl: '/hc/', // the base URL of your Help Center
|
|
86
81
|
poweredBy: true, // show the "Search by Algolia" link (required if you're on Algolia's FREE plan)
|
|
@@ -105,6 +100,7 @@ Here is a full breakdown of the available options for the JavaScript library:
|
|
|
105
100
|
useEditedAt: false // show edited_at timestamp in search results
|
|
106
101
|
},
|
|
107
102
|
instantsearchPage, // function to check if we're on the search page
|
|
103
|
+
indexPrefix: 'zendesk_', // @deprecated use `indexName` instead
|
|
108
104
|
templates: { // template objects (see the templates section)
|
|
109
105
|
autocomplete: {},
|
|
110
106
|
instantsearch: {}
|
|
@@ -363,9 +359,8 @@ Also, some templates are using a `compile` function in this file. This function
|
|
|
363
359
|
|
|
364
360
|
In case you're using Zendesk's [IP restrictions feature](https://support.zendesk.com/hc/en-us/articles/203663706-Restricting-access-to-Zendesk-Support-and-your-Help-Center-using-IP-restrictions), you'll need to whitelist our IPs for our indexing to work.
|
|
365
361
|
Here are those IPs:
|
|
366
|
-
- `
|
|
367
|
-
- `
|
|
368
|
-
- `52.22.248.248`
|
|
362
|
+
- `104.196.103.173`
|
|
363
|
+
- `35.234.69.129`
|
|
369
364
|
|
|
370
365
|
## Development
|
|
371
366
|
|
|
@@ -430,6 +425,7 @@ When running, you can then add this custom script to your Help Center, inside th
|
|
|
430
425
|
applicationId: 'FIXME',
|
|
431
426
|
apiKey: 'FIXME',
|
|
432
427
|
subdomain: 'FIXME',
|
|
428
|
+
indexName: 'FIXME',
|
|
433
429
|
})
|
|
434
430
|
</script>
|
|
435
431
|
```
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/*!
|
|
2
|
-
* Algolia Search for Zendesk's Help Center v2.
|
|
2
|
+
* Algolia Search for Zendesk's Help Center v2.31.0
|
|
3
3
|
* https://github.com/algolia/algoliasearch-zendesk
|
|
4
|
-
* Copyright
|
|
4
|
+
* Copyright 2023 Algolia <support@algolia.com>; Licensed MIT
|
|
5
5
|
*/
|
|
6
6
|
@charset "UTF-8";
|
|
7
7
|
/* Search by */
|