Biblioteka skryptów CGI

W ramach serwera internetowego udostępniamy bibliotekę skryptów CGI. Dzięki tym dynamicznym elementom możesz uatrakcyjnić swoją stronę www o nowe elementy.

Szybka nawigacja

1. Licznik
2. FormMail
3. Przekierowanie

Licznik

Licznik jest skryptem służącym do wyświetlania licznika na stronach internetowych. Korzystanie z niego polega na umieszczeniu w kodzie HTML następującego odwołania:

Parametry wywołania:

• df - identyfikator licznika.
• align - położenie obrazka licznika względem obrazka bazowego.
• chcolor - ustalanie koloru obrazka licznika.
• cdt - docelowa data odliczania.
• cdf - startowa data odliczania.
• comma - czy pokazywać przecinek przy trzeciej cyfrze od prawej?
• degrees lub angle - obrót obrazka o kąt.
• df - nazwa pliku z danymi licznika.
• dformat - format daty.
• display - co wyświetlać.
• frgb - kolor ramki.
• ft - szerokość ramki
• fy - Pełen rok (4 liczby).
• image - wyświetla obrazek GIF.
• incr - czy inkrementowac licznik.
• istrip - czy używać strip.gif czy nie.
• md - Maksymalna liczba cyfr do wyświetlenia.
• negate - pokazuje negaryw obrazka licznika.
• offset - Odległość od obrazka licznika do grawędzi obrazka bazowego.
• reload - Czy możliwy jest reload strony licznika.
• rotate - Czy zmieniać obrazek licznika.
• sdhms - Czy pokazywać dzień, godzinę, minutę, sekundę przy odliczaniu.
• sh - Czy licznik ma być ukryty.
• srgb, prgb - Zmiana koloru źródłowego na inny ustalony.
• st - wartość startowa licznika.
• timezone - Czy pokazywac strefę czasoą.
• tformat - format czasu (12 lub 24h)Time format, 12 or 24 hr.
• tr - Czy właczyć przezroczystość.
• trgb - Kolor przezroczystości.
• xy - Pozycja x i y względem obrazka bazowego.

FormMail

FormMail jest skryptem służącym do przesyłania zawartości formularza WWW na określony adres email. Korzystanie z niego polega na umieszczeniu w kodzie HTML formularza odpowiednich pól:

lub

Opcje wywołania:

• recipient - adres email na który ma być wysłana zawartość formularza, np. uzytkownik@etap.pl. Jest to jedyne pole wymagane przez FormMaila - pozostałe nie są obowiązkowe, jeżeli jest więcej niż jeden adres emailowy. Należy je podawać rozdzielone przecinkami. Te opcje stosuje się zazwyczaj gdy właściciel strony jest adresatem, w firmach lub gdy jest dużo adresatów czasem trzeba stosować inne opcje formularza.
• subject - temat listu przychodzącego z zawartością formularza, temat pokazuje się wtedy w nagłówku maila
• redirect - adres strony która zostanie wyświetlona osobie wypełniającej formularz po jego wysłaniu. Należy podać pełny adres URL, np. http://twoj.etap.pl/podziekowania.html.

Opcje w tagach <INPUT>:

• email - pozwala osobie wypełniającej formularz podać swój adres emailowy. Adres ten będzie umieszczony w liście w polu From:. Opcja ta powinna być polem tekstowym:
  
  
  <INPUT name="email">
  
  
• realname - pozwala osobie wypełniającej formularz podać swoje imię i nazwisko. Będą one również umieszczone w polu From: listu. Pole to powinno być także pole tekstowym.
  
  
  <INPUT name="realname">
  
  
• required - określa, które pola muszą zostać wypełnione przed wysłaniem. Ich nazwy powinny być podane w wartości pola:
  
  
  <INPUT type=hidden value="email,pole1,pole2" name=required>
  
  
• env_report - dodaje do listu z zawartością formularza wartości zmiennych systemowych ustawianych przez serwer WWW. Zawierają one przydatne informacje na temat maszyny z której wysłano formularz, przeglądarki itp. Nazwy zmiennych powinny być podane w wartości pola:
  
  
  <INPUT type=hidden value="REMOTE_ADDR,HTTP_USER_AGENT" name=env_report>
  
  
• sort - podaje porządek według którego mają być posortowane pola formularza przed wysłaniem ich emailem. Możliwe wartości to alphabetic (po nazwach pól) i order:pole1,pole2,... (z góry określona kolejność pól).
  Przykłady:
  
  
  <INPUT type=hidden value="alphabetic" name=sort>
  <INPUT type=hidden value="pole1,pole2,pole3" name=sort>
  
  
• print_config - pozwala dodać do wysyłanego listu wartości pól konfiguracyjnych skryptu Formmail.
  Przykład:
  
  
  <INPUT type=hidden value="email,subject,env_report" name=print_config>
  
  
• print_blank_fields - określa, czy w w liście mają być umieszczone puste (niewypełnione) pola formularza. Domyślnie FormMail pomija takie pola. Można to włączyć ustawiając wartość tej opcji na 1:
  
  
  <INPUT type=hidden value="1" name=print_blank_fields>
  
  
• missing_fields_redirect - określa adres strony która zostanie wyświetlona użytkownikowi, który nie wypełnił obowiązkowych pól podanych w opcji required. Należy podać pełny adres strony:
  
  
  <INPUT type=hidden value="http://your.host.com/error.html" name=missing_fields_redirect>
  
  

Przekierowanie

Redirurl jest skryptem służącym do przekierowania przeglądarki na wskazany adres URL.
Skrypt można stosować w tagach oraz formularzach. na przykład: