Under Construction
Fillable provides a simple Autocompletion System for Websites. Creating the possibility to add an intelligent and learning autocompletion to any formfield on your website.
## What is Fillable? Fillable provides a simple but clever Autocompletion System for Websites. It makes it easy to add autocompletion to any inputfield in your web formular.Fillable uses the input of users to learn new autocompletion terms and weight them. It creates collections of terms which fit perfectly for your targetgroup.
The autocompletion has a tolerance for spelling mistakes. This improves user experience by helping the user to find the correct spelling of a word.
Fillable comes as Standalone Software and has a very simple installation process. You can create new Autocompletion fields and maintain created Fillable fields with a comfortable Webbackend.
Autocompletion Userexperience is very depending on speed. Therefore Fillable provides a very fast reactiontime on user inputs.
Fillable uses internally one of the latest Elasticsearch Versions.
You can configure Fillable to use your own external Elasticsearch Cluster or let Fillable create its own Elasticsearch Cluster.
## Getting started ### Install as Standalone Service (Windows & Unix) 1. [Download](https://github.com/MeiSign/Fillable/releases/download/v0.0.2/Fillable-0.0.2-SNAPSHOT.zip) the latest stable Fillable Version or the latest successful [Travis compiled build](https://github.com/MeiSign/Fillable/releases/download/v99.99.99/Fillable.zip) (Current development Version) 2. Extract the archive to your Webserver 3. Enter the `bin` directory from terminal 4. Start Fillable with the `./fillable` or `fillable.bat` command depending on your osOn Unix system you have to make the start script executable with
chmod +x fillable
before you can start it from Terminal.
You can access the Fillable Webbackend now with your browser on port 9000.
- Clone this Git Repository
- Download & Install Play 2.2.1
- Enter the Fillable directory with Commandlinetool or terminal
- Run Fillable with
play start
orplay run
for development mode
You can access the Fillable Webbackend now with your browser on port 9000.
### Quickstep Guide This quickstep guide is supposed to show you how easy you can create an autocompletion form field with Fillable and embed it into your website.A working Installation of Fillable is required too use this guide. Please go back and proceed with the installation notes if you haven't installed Fillable on your system yet.
Let's say you ran a website about cars and your want an autocompletion form field that help users with brandnames (Hidden advertisements incoming ;-)).
The first step to your wonderful autocompletion form field ist to login to your Fillable Backend. You should be able to reach it under http://127.0.0.1:9000/ if you are working on the machine where Fillable is installed.
After the login screen your are redirected to the Fillable Index List. An Fillable Index is the data container of your autocompletion fields. Therefore you should see an empty list now what we will change in a second.
Click on Create Index under the list or in the main navigation to create our car brand field. In the following form we use the default values and enter the name "car_brands". Please note that only lowercase characters are allowed in indexnames.
Click on create and you will be redirected to a page that shows you a basic html snippet. Just copy the snippet and paste in into a new html file on your computer for now.
Your new autocompletion field is ready to use now! Open the html file in your browser and enter "Audi" into the input field. Click on submit, empty the textfield and start typing "Audi" again. You will see that it already gets suggested while you type.
These are the basics of Fillable. You can proceed with the following sections to get some additional information but your autocompletion is already working now. Every userinput will be remembered and weigthed based on the frenquency of a term.
### How to use an external Elasticsearch Cluster Using an external Elasticsearch Cluster might be very helpful when you want to use Fillable in production. If you have a lot of data for your autocompletion field you must certainly want to use the great Scalability of Elasticsearch. The embedded Elasticsearch only runs in a Single Node Cluster.To use your own external Elasticsearch cluster you have to edit the Fillable config. You can find it inside the conf
directory.
Change esclient.embeddedElasticsearch=true
to false
. And add one of your node addresses to the transport client urls.
Fillable/conf/fillable.conf
# Embedded Elasticsearch
# ~~~~~
# This option determines if you use an external elasticsearch cluster or embedded elasticsearch node
esclient.embeddedElasticsearch=false
# Nonembedded Elasticsearch
# ~~~~~
# If you deactivate the embedded Elasticsearch node add the cluster urls which shall be used by
# the elasticsearch transport client
esclient.transportClientUrls=["127.0.0.1:9300"]
It is possible to add more than one node address to the config but usually not necessary. The client will sniff the other nodes. However if you want to add several nodes you can do it like this
esclient.transportClientUrls=["127.0.0.1:9300", "127.0.0.1:9301"]