HTMLets

Z funus.net

Rozszerzenie HTMLets pozwala wstawiać na strony MediaWiki zawartość plików HTML-owych, umieszczonych na serwerze. Można dzięki temu w miarę bezpiecznie uzyskać dodatkową funkcjonalność.

Domyślnie pliki z HTML-em do użycia za pomocą tego rozszerzenia powinny się znajdować w podkatalogu htmlets katalogu, w którym zainstalowano MediaWiki. Można to jednak zmienić, ustawiając w pliku LocalSettings.php zmienną $wgHTMLetsDirectory.

Do stron MediaWiki zawartość pliku HTML-owego dołącza się korzystając z tagów <htmlet>:

<htmlet>nazwa_pliku</htmlet>

wstawiając oczywiście odpowiednią nazwę pliku, przy czym należy pominąć rozszerzenie .html.

Cache'owanie w parserze MediaWiki może powodować, że po zmianie zawartości włączanego pliku HTML-owego włączająca go strona MediaWiki się nie zmieni. Żeby tego uniknąć, można użyć atrybutu nocache:

<htmlet nocache="yes">nazwa_pliku</htmlet>

[edytuj] Przykład

Oto przykładowy HTML-owy formularz:

<html>
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 </head>
 <body style="font-family: sans-serif;">
 <p>Testowy formularz</p>
 <form style="font-family: serif; color: #c04020">
  <table style="color: inherit; border-collapse: collapse;">
   <tr><td>imię:</td><td><input type="text" name="firstname"/></td></tr>
   <tr><td>nazwisko:</td><td><input type="text" name="lastname"/></td></tr>
   <tr><td>rodzaj:</td></tr>
  </table>
  <input type="radio" name="sex" value="male"/>męski<br/>
  <input type="radio" name="sex" value="female"/>żeński<br/>
  <input type="radio" name="sex" value="other"/>nijaki<br/>
  <br/><input type="submit" value="Wyślij"/>   
 </form>
</body>
</html>

Po zapisaniu go na serwerze w pliku sample_html_form.html, można go włączyć na stronie wiki za pomocą tagu htmlet:

<htmlet>sample_html_form</htmlet>

Rezultat widoczny jest w ramce:

<htmlet>sample_html_form</htmlet>