mskrypty

mskrypty.ovh.org -> Download -> mImieniny -> Instalacja i konfiguracja

mIemininy - Instalacja i konfiguracja

Wymagania:

PHP 4.3 lub nowsze.

Instalacja:

  • Rozpakuj archiwum.
  • Aby zaobserwować jak działa skrypt odwołaj się w przeglądarce do pliku index.php..

    Jeżeli chcesz wstawić skrypt na swoją stronę, czytaj dalej.
    Przenieś rozpakowane pliki (z wyjątkiem pliku index.php) do katalogu, w którym znajduje się plik html, w którym chcesz wyświetlić imieniny, a następnie w tym pliku:
    • na samym początku wstaw kod:

      <?php

      include('./config.php');
      include('./classes.php');

      ?>
    • w miejscu gdzie chcesz wyświetlić imiona jubilatów wstaw kod:

      <?php

      new MNameDay();

      ?>
    • Odwołaj się poprzez przeglądarkę do pliku zmodyfikowanego w powyżej opisany sposób. Powinieneś na ekranie otrzymać w wybranym przez siebie miejscu datę oraz imiona jubilatów.

    Konfiguracja:

    W pliku config.php znajdują się zmienne konfiguracyjne, których wartości można zmieniać.

    Zmienna $showDate przyjmuje wartości true lub false. true oznacza, że wyświetlona zostanie data, false ? data nie zostanie wyświetlona.
    Zmienna $separator ? jeżeli $showDate = true, to zawartość zmiennej $separator jest wstawiana między człony daty.
    Zmienna $intrText ? może być użyta do umieszczenia dodatkowego tekstu przed wypisaniem imion jubilatów, np. 'Dzisiaj świętują: '.
    Zmienna $dirWithNames ? przechowuje ścieżkę do katalogu z plikami zawierającymi imieniny dla poszczególnych dat.

    Pliki z imieninami muszą mieć nazwę będącą numerem miesiąca, dla którego dane przechowują. Nazwa musi być jednak dwuliterowa, zatem dla miesięcy styczeń ? wrzesień nazwy plików to 01.txt ? 09.txt.
    Pliki z imionami muszą mieć rozszerzenie txt!

    Pliki z imionami zawierają tyle linii, ile dni ma dany miesiąc. Jak łatwo się domyślić, w każdej linii przechowywane są imieniny dla jednego dnia. Poszczególne imiona oddzielone są znakiem: | . Należy o tym pamiętać w przypadku wszelkich modyfikacji tych plików. Inny format tych plików spowoduje nieprawidłowe działanie skryptu.

    Licencja:

    Skryptu mImieniny można używać za darmo pod warunkiem umieszczenia na stronie, na której skrypt zostanie wykorzystany zapisu: ?mImieniny by mim? wraz z odnośnikiem do strony http://mskrypty.ovh.org/mimieniny.php. Odpowiedni fragment kodu html, który można wykorzystać znajduje się w pliku index.php..