[UNOFFICIAL] Algolia is a pure dart SDK, wrapped around Algolia REST API for easy implementation for your Flutter or Dart projects.
- Query / Search
- Get Object
- Add Object
- Add Objects
- Replace all objects in an Index
- Update Object
- Partial Update Object
- Delete Object
- Perform Batch Activities
- Add Index
- Delete Index
- Clear Index
- Copy Index
- Move Index
- Index Settings
See CHANGELOG for all breaking (and non-breaking) changes.
If you wish to contribute in our development process, refer to our Contributing Guidelines
You should ensure that you add the router as a dependency in your flutter project.
dependencies:
algolia: ^0.1.6+1You should then run flutter packages upgrade or update your packages in IntelliJ.
There is a pretty sweet example project in the example folder. Check it out. Otherwise, keep reading to get up and running.
///
/// Initiate static Algolia once in your project.
///
class Application {
static final Algolia algolia = Algolia.init(
applicationId: 'YOUR_APPLICATION_ID',
apiKey: 'YOUR_API_KEY',
);
}
void main() async {
///
/// Initiate Algolia in your project
///
Algolia algolia = Application.algolia;
///
/// Perform Query
///
AlgoliaQuery query = algolia.instance.index('contacts').search('john');
// Perform multiple facetFilters
query = query.setFacetFilter('status:published');
query = query.setFacetFilter('isDelete:false');
// Get Result/Objects
AlgoliaQuerySnapshot snap = await query.getObjects();
// Checking if has [AlgoliaQuerySnapshot]
print('Hits count: ${snap.nbHits}');
///
/// Perform Index Settings
///
AlgoliaIndexSettings settingsRef = algolia.instance.index('contact').settings;
// Get Settings
Map<String, dynamic> currentSettings = await settingsRef.getSettings();
// Checking if has [Map]
print('\n\n');
print(currentSettings);
// Set Settings
AlgoliaSettings settingsData = settingsRef;
settingsData = settingsData.setReplicas(const ['index_copy_1', 'index_copy_2']);
AlgoliaTask setSettings = await settingsData.setSettings();
// Checking if has [AlgoliaTask]
print('\n\n');
print(setSettings.data);
}Here is the list of parameters you can use with the search method (search scope). We have managed to include most commonly used parameters for search functionality and there many more to be added in future releases.
We have indicated counts of queryable parameters with their availability status on official Algolia website and what we have managed to support it in this version of the release.
.search(String value)
.setAttributesToRetrieve(List<String> value).setRestrictSearchableAttributes(List<String> value)
.setFilters(String value).setFacetFilter(dynamic value)This can be used multiple times in a query..setOptionalFilter(String value)This can be used multiple times in a query..setNumericFilter(String value)This can be used multiple times in a query..setTagFilter(String value)This can be used multiple times in a query..setSumOrFiltersScore(bool value)
.setFacets(List<String> value).setMaxValuesPerFacet(int value).setFacetingAfterDistinct({bool enable = true}).setSortFacetValuesBy(AlgoliaSortFacetValuesBy value)
.setAttributesToHighlight(List<String> value).setAttributesToSnippet(List<String> value).setHighlightPreTag(String value).setHighlightPostTag(String value).setSnippetEllipsisText(String value).setRestrictHighlightAndSnippetArrays({bool enable = true})
.setPage(int value).setHitsPerPage(int value).setOffset(int value).setLength(int value)
.setMinWordSizeFor1Typo(int value).setMinWordSizeFor2Typos(int value).setTypoTolerance(dynamic value).setAllowTyposOnNumericTokens(bool value).setDisableTypoToleranceOnAttributes(List<String> value)
.setAroundLatLng(String value).setAroundLatLngViaIP(bool value).setAroundRadius(dynamic value).setAroundPrecision(int value).setMinimumAroundRadius(int value).setInsideBoundingBox(List<BoundingBox> value).setInsidePolygon(List<BoundingPolygonBox> value)
.getObjects()
Here is the list of parameters you can use with the settings method (settings scope). We have managed to include most commonly used parameters for settings functionality and there many more to be added in future releases.
We have indicated counts of settings parameters with their availability status on official Algolia website and what we have managed to support it in this version of the release.
.setSearchableAttributes(List<String> value).setAttributesForFaceting(List<String> value).setUnretrievableAttributes(List<String> value).setAttributesToRetrieve(List<String> value)
.setRanking(List<String> value).setCustomRanking(List<String> value).setReplicas(List<String> value)
.setMaxValuesPerFacet(int value).setSortFacetValuesBy(AlgoliaSortFacetValuesBy value)
.setAttributesToHighlight(List<String> value).setAttributesToSnippet(List<String> value).setHighlightPreTag(String value).setHighlightPostTag(String value).setSnippetEllipsisText(String value).setRestrictHighlightAndSnippetArrays({bool enable = true})
.setHitsPerPage(int value).setPaginationLimitedTo(int value)
.setMinWordSizeFor1Typo(int value).setMinWordSizeFor2Typos(int value).setTypoTolerance(dynamic value).setAllowTyposOnNumericTokens(bool value).setDisableTypoToleranceOnAttributes(List<String> value).setDisableTypoToleranceOnWords(List<String> value).setSeparatorsToIndex(List<String> value)
.setAttributeForDistinct(String value).setDistinct({dynamic value = 0}).setGetRankingInfo({bool enabled = true}).setClickAnalytics({bool enabled = false})
.getSettings()
.setSettings()
Algolia [Unofficial SDK for Dart] is a Knoxpo original.
