>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #1604784. --> Reported by: [teelmo](https://www.drupal.org/user/426628) >>> <p>Onki module integrates Onki ontology services into Drupal taxonomies.</p> <p><img src="http://drupal.org/files/imagecache/grid-3/project-images/onki-logo-05-200x70.png" alt="Onki"></p> <h3>About Onki</h3> <p><a href="http://onki.fi/">The ONKI service</a> contains Finnish and international ontologies, vocabularies and thesauri needed to publishing your content with support for <a href="http://en.wikipedia.org/wiki/Linked_data">linked data</a>. Ontologies are conceptual models identifying the concepts of a domain. They contain machine "understandable" descriptions of the relations between the concepts.</p> <p>ONKI is published and currently maintained by <a href="http://www.seco.tkk.fi/news/">Semantic Computing Research Group SeCo</a>. The Finnish Government is also involved in the development and future proofing - press release <a href="http://www.vm.fi/vm/sv/03_pressmeddelanden_och_tal/01_pressmeddelanden/20121115Minist/name.jsp">in Swedish</a>, <a href="http://www.vm.fi/vm/fi/03_tiedotteet_ja_puheet/01_tiedotteet/20121115Hallin/name.jsp">Finnish</a> and <a href="http://translate.google.com/translate?sl=sv&amp;tl=en&amp;js=n&amp;prev=_t&amp;hl=sv&amp;ie=UTF-8&amp;eotf=1&amp;u=http%3A%2F%2Fwww.vm.fi%2Fvm%2Fsv%2F03_pressmeddelanden_och_tal%2F01_pressmeddelanden%2F20121115Minist%2Fname.jsp&amp;act=url">English (Google translate)</a>.</p> <h3>Onki module</h3> <p>Onki Drupal module integrates Onki service with Drupal taxonomies. This way you can use Onki terms to describe (tag) desired content types. </p> <h3>Preparations</h3> <p>To set up ONKI module you have to have at least <strong>one content type</strong> <em>(i.e. article)</em> and <strong>a taxonomy</strong> <em>(i.e. tags)</em> configured in your system.</p> <p>To create a content type browse to:<br> /admin/structure/types/add</p> <p>To create a taxonomy browse to:<br> /admin/structure/taxonomy/add</p> <p>To use this module <strong>you need to <a href="http://onki.fi/en/signup/">register an API key</a></strong> for Onki service. The API key is per IP address.</p> <h3>Install and configure</h3> <p><strong>1. Download or clone ONKI module from Sandbox:</strong></p> <ul> <li>git clone <a href="http://git.drupal.org/sandbox/teelmo/1596454.git">http://git.drupal.org/sandbox/teelmo/1596454.git</a> onki</li> <li><a href="http://drupal.org/sandbox/teelmo/1596454">http://drupal.org/sandbox/teelmo/1596454</a></li> </ul> <p><strong>2. Enable ONKI module:</strong></p> <ul> <li>/admin/modules</li> </ul> <p><strong>3. Configure ONKI module's settings:</strong></p> <ul> <li>/admin/config/content/onki</li> </ul> <p>There are many settings options, but the example values provided work in most cases.</p> <p><a href="http://drupal.org/files/project-images/Screen%20Shot%202012-11-09%20at%2013.57.01.png" class="imagecache imagecache-grid-3 imagecache-imagelink imagecache-grid-3_imagelink"><img src="http://drupal.org/files/imagecache/grid-3/project-images/Screen%20Shot%202012-11-09%20at%2013.57.01.png" alt="Onki admin settings" title="" class="imagecache imagecache-grid-3" width="220" height="217"></a></p> <p>After you have set up all the settings you can try the service. If you attached Onki to the article content type you browse to:</p> <ul> <li>/node/add/article</li> </ul> <p>You should see an Onki field which allows you to add new terms. The autocomplete feature should kick in when you start to type in your terms. If not, check your settings and specially your language and API key settings.</p> <p><a href="http://drupal.org/files/project-images/Screen%20Shot%202012-11-09%20at%2014.49.26.png" class="imagecache imagecache-grid-3 imagecache-imagelink imagecache-grid-3_imagelink"><img src="http://drupal.org/files/imagecache/grid-3/project-images/Screen%20Shot%202012-11-09%20at%2014.49.26.png" alt="Onki user interface" title="" class="imagecache imagecache-grid-3" width="220" height="194"></a></p> <p>After you save your article you see the Onki URL, not the human-readable title. You can fix this by managing content type's display. So for example if you are using the article content type you browse to:<br> admin/structure/types/manage/article/display</p> <p>where you can select "Onki field" as the format. You should do this for both <em>default</em> and <em>teaser</em> display modes.</p> <p><a href="http://drupal.org/files/project-images/Screen%20Shot%202012-11-09%20at%2015.07.57.png" class="imagecache imagecache-grid-3 imagecache-imagelink imagecache-grid-3_imagelink"><img src="http://drupal.org/files/imagecache/grid-3/project-images/Screen%20Shot%202012-11-09%20at%2015.07.57.png" alt="" title="" class="imagecache imagecache-grid-3" width="220" height="131"></a></p> <p>Thats it! Congratz!</p> <h3>Other information</h3> <p>This module was developed &amp; sponsored by svenska.yle.fi (part of <a href="http://drupal.org/node/1296538">Yle - Finnish Broadcasting Company</a>). The developers are Teemo Tebest (<a href="http://yle.fi/">Yleisradio</a>) and Tomi Mikola (<a href="http://www.wunderkraut.com/">Wunderkraut</a>). The module is currently used in production by <a href="http://svenska.yle.fi">Svenska Yle</a> (Launch april 2012).</p> <p>Onki module makes use of CSS3.</p> <p><strong>Project's sandbox page:</strong><br> <a href="http://drupal.org/sandbox/teelmo/1596454">http://drupal.org/sandbox/teelmo/1596454</a></p> <p><strong>Git repository usage:</strong><br> <em>git clone <a href="mailto:teelmo@git.drupal.org">teelmo@git.drupal.org</a>:sandbox/teelmo/1596454.git onki</em></p> <p>The above command should be run for example in your <em>{drupal_root}/sites/all</em> folder.</p> <p><strong>Drupal Version:</strong><br> Drupal 7.x, tested with 7.17</p>