Tagowa chmurka

Opis działania

Przeznaczeniem skryptu mktags.js jest przekształcanie zwykłej listy kategorii w tagową chmurkę (ang. Tagcloud).

Skąd pobrać

Aktualna wersja skryptu znajduje się pod tym adresem.

Przygotowywanie szablonu

W sekcji head należy dodać następijącą linijkę:

<script type="text/javascript" src="/files/mktags.js"></script>

W dowolnym miejscu w szablonie wklejamy kod:

<p id="tags">
<CATEGORY_BLOCK>
       <a id="&CATEGORY_ID;" href="&CATEGORY_HREF;" title="&CATEGORY_ENTRIES;"><CATEGORY_HREF_DESCR/></a>
<span>(<CATEGORY_ENTRIES/>)</span>
</CATEGORY_BLOCK>
</p>

Ostatnim krokiem jest wysłanie pliku mktags.js na joggera za pomocą panelu administracyjnego.

Kompatybilność z przeglądarkami nieobsługującymi JavaScript

Zastosowanie rozwiązania nie mają wielkiego wpływu na obniżenie dostępności strony. Osobom przeglądającym za pomocą przeglądarek, które nie obsługują JavaScriptu, bądź mają go wyłączone, będzie wyświetlać się zwykła lista kategorii.

Modyfikacje użytkownika

Skrypt przewiduje możliwość łatwej modyfikacji poprzez użytkownika nieznającego się na JavaScripcie. Wszelkie parametry, które można zmienić, znajdują się na początku pliku i są poprzedzone słowem var.

Opis parametrów

tagid

Oznacza atrybut id tagu, w którym znajduje się lista kategorii.

defRed, defBlue, defGreen

Procentowa wartość koloru czerwonego, niebieskiego i zielonego lub null, jeśli chcemy, by wartość danego koloru zmieniała się w zależności od ilości wpisów przyporządkowanych danej kategorii.

defMax, defMin

Procentowa wartość maksymalna i minimalna, między którymi kolor zdefiniowany w zmiennej defRed, defBlue lub defGreen może zmieniać swą wartość.

direction

Jeśli true, wtedy wartość koloru rośnie od wartości minimalnej do maksymalnej wraz ze wzrostem ilości wpisów przyporządkowanch danej kategorii, jeśli false, wtedy wartość koloru maleje od maksymalnej do minimalnej.

hideItems

Jeśli true, wszystkie elementy span wewnątrz tagu oznaczonego zmienną tagid będą niewidoczne po wykonaniu skryptu.

Autorzy

• Głównym autorem kodu jest Michał Moroz aka dragonee. [1]
• Twórcą implementacji funkcji AttachEvent jest Gavin Kistner. [2]

Licencja

• Skrypt, poza implementacją funkcji AttachEvent jest rozprowadzany jako public domain.
• Implementacja funkcji AttachEvent jest rozprowadzana na licencji dostępnej tutaj.