Cloned the wiki page

Author: msiemczyk

ui-select.wiki/Accessing-$select.md

@@ -0,0 +1,30 @@
+Many requests for custom features can be satisfied by accessing the `uiSelectController` in your own custom directive. 
+
+To do this, create a directive of your own which `require`s the `uiSelect` directive, as shown below:
+
+```js
+myModule.directive('myUiSelect', function() {
+  return {
+    require: 'uiSelect',
+    link: function(scope, element, attrs, $select) {
+      
+    }
+  };
+});
+```
+
+Using it as illustrated below:
+```
+<ui-select my-ui-select ng-model="person.selected">
+  <ui-select-match> ... </ui-select-match>
+  <ui-select-choices> ... </ui-select-choices>
+</ui-select>
+```
+
+Refer to the source code of [`uiSelectController`](https://github.com/angular-ui/ui-select/blob/master/src/uiSelectController.js) to see what is functionality is available through this API. 
+
+If you feel your directive may be useful to others, feel free to submit it is as a Pull Request for consideration for inclusion in the library.
+
+### Examples
+1. [Select active item on Blur](https://github.com/angular-ui/ui-select/issues/1544#issuecomment-204028310)
+2. [Placeholder Always Visible](https://github.com/angular-ui/ui-select/pull/1433#issuecomment-225011882)

ui-select.wiki/FAQs.md

@@ -0,0 +1,93 @@
+## Common Issues
+
+### ng-model not working with a simple variable on $scope
+
+You cannot write:
+```HTML
+<ui-select ng-model="item"> <!-- Wrong -->
+  [...]
+</ui-select>
+```
+
+You need to write:
+```HTML
+<ui-select ng-model="item.selected"> <!-- Correct -->
+  [...]
+</ui-select>
+```
+
+Or:
+```HTML
+<ui-select ng-model="$parent.item"> <!-- Hack -->
+  [...]
+</ui-select>
+```
+
+For more explanations, check [ui-select #18](https://github.com/angular-ui/ui-select/issues/18) and [angular.js #6199](https://github.com/angular/angular.js/issues/6199).
+
+### ng-bind-html gives me "Error: [$sce:unsafe] Attempting to use an unsafe value in a safe context"
+
+You need to use module [ngSanitize](http://docs.angularjs.org/api/ngSanitize) (recommended) or [$sce](http://docs.angularjs.org/api/ng/service/$sce):
+
+```JavaScript
+$scope.trustAsHtml = function(value) {
+  return $sce.trustAsHtml(value);
+};
+```
+
+```HTML
+<div ng-bind-html="trustAsHtml((item | highlight: $select.search))"></div>
+```
+
+### I get "TypeError: Object [...] has no method 'indexOf' at htmlParser"
+
+You are using ng-bind-html with a number:
+```HTML
+<div ng-bind-html="person.age | highlight: $select.search"></div>
+```
+
+You should write instead:
+```HTML
+<div ng-bind-html="''+person.age | highlight: $select.search"></div>
+```
+
+Or:
+```HTML
+<div ng-bind-html="person.age.toString() | highlight: $select.search"></div>
+```
+
+Or:
+```HTML
+<div ng-bind-html="String(person.age) | highlight: $select.search"></div>
+```
+
+### How do I stop the drop-down from getting cut off by the bottom of my Bootstrap modal / container with `overflow: hidden`?
+
+Add `append-to-body="true"` to the `ui-select` tag. See the [`ui-select` directive wiki page](https://github.com/angular-ui/ui-select/wiki/ui-select).
+
+### Filter highlighter ruin words in some languages such as Persian and arabic
+
+You can use zwjHighlighter from following url: https://github.com/deadmann/AngularJSComponent
+It provided for persian language, and you may need to add your own language letters (only those who should stick to next letter) to the list of regex.
+```JavaScript
+function isZeroWidthJoiner(first, second){
+    //Get First Character and match Whitespaces
+    if(second.substr(0,1).match(/\s+/))
+      return false;
+
+    //TODO: MODIFY HERE
+    return !!first.substr(first.length>0?first.length-1:0).match(/[يئبپتجچحخسشصضطظعغفقکگلمنهی]/);
+  }
+```
+
+### Highlight filter doesn't support special characters (like accents)
+
+Here is a gist with a highlight filter with accent support: https://gist.github.com/juannorris/fa32fb015acd1496c6dfd55b5359a1f9
+
+Which you can then use as:
+
+```HTML
+<div ng-bind-html="(name | customHighlight: $select.search) | trustAsHTML"></div>
+```
+
+The filter should be able to support any special characters you need, by updating the `normalize` function accordingly.

ui-select.wiki/Getting-Started.md

@@ -0,0 +1,91 @@
+### Requirements
+
+- Angular >=1.2.18
+- ngSanitize module
+- jQuery ( optional for older browser support )
+- Bootstrap (v3)/Select2/Selectize CSS as appropriate
+
+Browser compatibility starting at Internet Explorer 8 and Firefox 3.6.
+
+
+### Installing
+
+There are multiple ways of adding the required files:
+
+1) Clone, build the repository, and include the files
+
+2) Link to a [CDN](https://cdnjs.com/libraries/angular-ui-select)
+
+3) Install via Bower and include files
+
+    bower install angular-ui-select
+    
+reference the scripts 
+
+- `bower_components/angular-ui-select/dist/select.js`
+- `bower_components/angular-ui-select/dist/select.css` 
+
+---
+
+For IE8 / FF3.6 support you must include:
+
+      <!--
+        IE8 support, see AngularJS Internet Explorer Compatibility http://docs.angularjs.org/guide/ie
+        For Firefox 3.6, you will also need to include jQuery and ECMAScript 5 shim
+      -->
+      <!--[if lt IE 9]>
+        <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.11.0/jquery.js"></script>
+        <script src="http://cdnjs.cloudflare.com/ajax/libs/es5-shim/2.2.0/es5-shim.js"></script>
+        <script>
+          document.createElement('ui-select');
+          document.createElement('ui-select-match');
+          document.createElement('ui-select-choices');
+        </script>
+      <![endif]-->
+
+For RequireJS, your setup might look like:
+
+    require.config({
+        paths: {
+            'angular': 'bower_components/angular/angular',
+            'angular-ui-select': 'bower_components/angular-ui-select/dist/select'
+        },
+        shim: {
+            'angular-ui-select': ['angular']
+        }
+    });
+
+
+Include the ui.select and ngSanitize modules in your application
+
+    var module = angular.module('myapp', ['ui.select', 'ngSanitize']);
+
+### Basic example
+The most basic use of the directive in html ([plunker](http://plnkr.co/edit/K9alAMAzvUqCY7Or8RwY?p=preview))
+```html
+<ui-select ng-model="selected.value">
+    <ui-select-match>
+        <span ng-bind="$select.selected.name"></span>
+    </ui-select-match>
+    <ui-select-choices repeat="item in (itemArray | filter: $select.search) track by item.id">
+        <span ng-bind="item.name"></span>
+    </ui-select-choices>
+</ui-select>
+```
+With a related angular controller:
+```javascript
+angular.module('app')
+.controller('ctrl', ['$scope', function ($scope){
+    $scope.itemArray = [
+        {id: 1, name: 'first'},
+        {id: 2, name: 'second'},
+        {id: 3, name: 'third'},
+        {id: 4, name: 'fourth'},
+        {id: 5, name: 'fifth'},
+    ];
+
+    $scope.selected = { value: $scope.itemArray[0] };
+}]);
+```
+
+_Note: Including additional stylesheets is required, depending on which theme is used, in order to have ui-select render as a dropdown box. The examples show which resources to use._

ui-select.wiki/Home.md

@@ -0,0 +1,8 @@
+#### [1. Getting Started](https://github.com/angular-ui/ui-select/wiki/Getting-Started)
+#### [2. ui-select Directive](https://github.com/angular-ui/ui-select/wiki/ui-select)
+#### [3. ui-select-match Directive](https://github.com/angular-ui/ui-select/wiki/ui-select-match)
+#### [4. ui-select-choices Directive](https://github.com/angular-ui/ui-select/wiki/ui-select-choices)
+#### [5. ui-select-no-choice Directive](https://github.com/angular-ui/ui-select/wiki/ui-select-no-choice)
+#### [6. uis-open-close Directive](https://github.com/angular-ui/ui-select/wiki/uis-open-close)
+#### [7. FAQs](https://github.com/angular-ui/ui-select/wiki/FAQs)
+#### [8. Accessing `$select`](https://github.com/angular-ui/ui-select/wiki/Accessing-$select)

ui-select.wiki/Roadmap.md

@@ -0,0 +1,29 @@
+Just to throw it all somewhere
+
+* [x] Customizeable selected template
+* [x] Customizeable list item template
+* [x] Keyboard selection (up/down/enter)
+* [ ] Use left/right arrow keys to move the caret (ibeam) between items (multi-select)
+* [x] Filtering list by typing
+* [x] Capable of handling rich objects array
+* [x] Async data (handled by AngularJS and `ng-repeat`)
+* [ ] Pagination (far-future) [#316](https://github.com/angular-ui/ui-select/issues/316)
+  * [ ] Scroll-based pagination (far-far-future)
+* [x] List Groups (future)
+* [ ] Validation (max/min/etc)
+* [ ] Tokenization using commas or string-separator (far-far-future)
+* [x] Keyboard shortcuts 
+  * [x] tabable
+  * [x] backspace/del to clear the value while closed
+  * [x] Key Down to open
+* [ ] Position
+  * [ ] Append list to body or any other element [#41](https://github.com/angular-ui/ui-select/issues/41)
+  * [ ] [Collision flip](http://api.jqueryui.com/position/) - Show the list above the target (if it dosen't fit) [#234](https://github.com/angular-ui/ui-select/issues/234)
+
+Options(?):
+* [x] Close on selection
+* [x] Multi-select (tagging) & single-select
+* [ ] Custom sorting / matching / filtering
+* [ ] opt-out on Android/iOS devices 
+
+This covers almost everything select2 is capable of doing, which is by far the most comprehensive solution currently available.

ui-select.wiki/_Sidebar.md

@@ -0,0 +1 @@
+###