https://github.com/krolow/komplete
CakePHP 2 Plugin that aims to make easily the autocomplete fuctionality
https://github.com/krolow/komplete
Last synced: about 1 month ago
JSON representation
CakePHP 2 Plugin that aims to make easily the autocomplete fuctionality
- Host: GitHub
- URL: https://github.com/krolow/komplete
- Owner: krolow
- Created: 2012-12-11T23:22:15.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2013-07-18T19:01:30.000Z (almost 12 years ago)
- Last Synced: 2025-04-15T20:13:52.647Z (about 1 month ago)
- Language: PHP
- Homepage:
- Size: 76.2 KB
- Stars: 6
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Komplete [](https://travis-ci.org/krolow/Komplete)
CakePHP 2.0 Plugin that aims to make easily the autocomplete fuctionality
## Requirements
- PHP 5.3
- CakePHP 2.0 or >
## Installation
- Clone from github: in your app directory type `git clone [email protected]:krolow/Komplete.git Plugin/Komplete`
- Download an archive from github and extract it in `app/Plugin/Komplete`
## When use it?
### Autocomplete functionality
Several times you want to make one input autcomplete, for the front-end side we have serveral solutions that works pretty well, but in the back-end side we have always to code that feature.
Komplete aims to make plug and play the autocomplete featurein the back-end side.
#### How?
It provides to you one controller action that answer as json the autocomplete functionality, and one behavior to save the data tha comes from the input field.
* It look for existent data
* Performs update/insert
* Performs the relationship between data
* Works with multiple data
* Works with single data
### Import data
Import data is always another boring task, we have always to check if the data already exists in the database case it does not exists we should insert and create the relations.
Using Komplete you don't need more to care about this, you just enable Komplete and let the behavior handle that task to you, you pass one field as string, define what will be the property of database that you want to use as the search, and it will look for in database to you, case it exists in database will create the relations need, case not it will insert and also create the relations.
### How it works?
#### Using as autocomplete
**In your model:**
```php
array(
'relations' => array(
'Technology' => array(
'multiple' => true,
'field' => 'name',
),
'City' => array(
'multiple' => false,
'field' => 'name',
),
),
'separator' => ','
)
);
/**
* belongsTo associations
*
* @var array
*/
public $belongsTo = array(
'City',
);
/**
* hasAndBelongsToMany associations
*
* @var array
*/
public $hasAndBelongsToMany = array(
'Technology' => array(
'className' => 'Technology',
'joinTable' => 'technologies_events',
'foreignKey' => 'event_id',
'associationForeignKey' => 'technology_id',
'unique' => 'keepExisting',
'conditions' => '',
'fields' => '',
'order' => '',
'limit' => '',
'offset' => '',
'finderQuery' => '',
'deleteQuery' => '',
'insertQuery' => ''
)
);
```
**In your view:**
```php
Form->create('Event', array('type' => 'file'));
echo $this->Form->input(
'Event.City',
array(
'type' => 'text',
'class' => 'komplete input-xlarge',
'data-multiple' => false,
'data-link' => $this->Html->url(
array(
'controller' => 'complete',
'action' => 'search',
'plugin' => 'komplete',
'Event',
'City',
'ext' => 'json'
),
true
)
)
);
echo $this->Form->input(
'Event.Technology',
array(
'type' => 'text',
'class' => 'komplete input-xlarge',
'data-multiple' => true,
'data-link' => $this->Html->url(
array(
'controller' => 'complete',
'action' => 'search',
'plugin' => 'komplete',
'Event',
'Technology',
'ext' => 'json'
),
true
)
)
);
?>
Html->script(
array(
'/js/autocomplete.js',
),
array(
'inline' => false
)
);
?>
```
**The javascript example, in this case using bootstrap of github and jquery:**
```javascript
$(document).ready(function () {
$('.komplete').typeahead({
source : function (query, process) {
var multiple = $(this)[0].$element[0].dataset.multiple;
if (multiple) {
query = $.trim(query.split(',').pop());
}
$.getJSON(
$(this)[0].$element[0].dataset.link,
{search : query},
function (data) {
process(data.options);
}
);
},
updater : function (item) {
var field = $($(this)[0].$element[0]);
var previous_items = field.val();
var terms = previous_items.split(',');
terms.pop();
terms.push(item);
$.each(terms, function(idx, val) { terms[idx] = $.trim(val); });
return terms.join(', ');
},
matcher: function() { return true; },
autoselect: false,
highlighter : function (item) {
var terms = this.query.split(',');
var query = $.trim(terms.pop(-1))
return item.replace(new RegExp('(' + query + ')', 'ig'), function ($1, match) {
return '' + match + ''
});
}
});
});
```
#### Using to import
**In your model:**
```php
array(
'relations' => array(
'Technology' => array(
'multiple' => true,
'field' => 'name',
),
'City' => array(
'multiple' => false,
'field' => 'name',
),
),
'separator' => ','
)
);
/**
* belongsTo associations
*
* @var array
*/
public $belongsTo = array(
'City',
);
/**
* hasAndBelongsToMany associations
*
* @var array
*/
public $hasAndBelongsToMany = array(
'Technology' => array(
'className' => 'Technology',
'joinTable' => 'technologies_events',
'foreignKey' => 'event_id',
'associationForeignKey' => 'technology_id',
'unique' => 'keepExisting',
'conditions' => '',
'fields' => '',
'order' => '',
'limit' => '',
'offset' => '',
'finderQuery' => '',
'deleteQuery' => '',
'insertQuery' => ''
)
);
```
**Importing:**
```php
array(
'name' => 'Testing',
'City' => 'Pelotas',
'Technology' => 'PHP, Python, Javascript'
)
);
$this->Event->save($data);
}
}
```
## License
Licensed under The MIT License
Redistributions of files must retain the above copyright notice.
## Author
Vinícius Krolow - krolow[at]gmail.com