Przeszukując zasoby polskiej sieci można znaleźć kilka
serwisów, które oferują twórcom stron możliwość skorzystania z modułów prezentacji kursów walut za darmo.
Niestety żaden z bezpłatnych czy nawet tanich modułów nie oferuje zbyt dużych możliwości konfiguracji.
Dlatego postanowiliśmy stworzyć moduł, którgo możliwości konfiguracji wystarczą najbardziej wymagającym webmasterom
i jednocześnie udostępnić go za darmo.
NOWOŚCI!
Nowy parametr flag.
Pozwala on zaprezentuwać graficzne flagi państw przy kodzie waluty.
Poniżej znajdą Państwo przykład i objaśnienia.
Wprowadziliśmy możliwość samodzielnego dopasowania modułu do dowolnego języka.
Aby włączyć swój własny plik tłumaczeń należy dodać do linku parametr: lang=ścieżka_do_pliku
Dokładniejsze objaśnienia znajdą Państwo poniżej.
Udostępniliśmy możliwość wyświetlania kursów archiwalnych.
Aby włączyć archiwa należy dodać do linku parametr: archive=1.
Dokładniejsze objaśnienia znajdą Państwo poniżej.
Korzystanie z modułu jest bezpłatne.
Jedynym warunkiem jest zachowanie widocznego linku prowadzącego do strony 'waluty.arkis.pl'.
|
Jeżeli chcą Państwo skorzystać z wersji pozbawionej linku do 'waluty.arkis.pl'
zapraszamy do zakupienia wersji płatnej za jedyne 27 zł netto.
Prosimy wtedy o kontakt przy pomocy
formularza kontaktowego.
Tak może wyglądać Twoja tabela walut:
Licencja jest bezterminowa.
Zapewnia korzystanie ze wszystkich, wprowadzonych w przyszłości, udogodnień i poprawek. |
Kursy walut pobierane są bezpośrednio ze strony NBP z uwzględnieniem Uchwały Nr 51/2002 Zarządu Narodowego
Banku Polskiego z dnia 23 września 2002 r. w sprawie sposobu wyliczania i ogłaszania bieżących kursów walut
obcych (Dz. Urz. NBP Nr 14, poz. 39 i Nr 20, poz. 51 oraz z 2004 r. Nr 2, poz. 3).
Typowe wywołanie modułu pozwoli zaprezentować następującą tabelę:
|
| waluta |
kurs |
1 USD |
3.9989 |
1 EUR |
4.3350 |
1 CHF |
4.6144 |
1 GBP |
5.1982 |
1 CZK |
0.1709 |
|
Aby zamieścić tabelę kursów na swojej stronie należy wstawić na nią następujący kod:
Można tutaj sterować szerokościa i wysokością ramki (width i height w parametrach IFRAME).
TYM CO ODRÓŻNIA naszą ofertę od innych jest możliwość sterowania wieloma innymi
parametrami wyświetlania tabeli kursów.
Aby zmienić liczbę wyświetlanych kolumn, należy dodać do wywołania parametr cols:
( http://waluty.arkis.pl/kursy_webmaster.php?cols=3 )
|
| waluta |
kurs |
1 USD |
3.9989 |
1 GBP |
5.1982 |
|
| waluta |
kurs |
1 EUR |
4.3350 |
1 CZK |
0.1709 |
|
|
Aby wyświetlić tylko określone waluty należy dodać do wywołania parametr waluty:
( http://waluty.arkis.pl/kursy_webmaster.php?waluty=eur,cad,rub,sek&cols=4 )
Aby wyświetlić wszystkie dostępne waluty należy parametrowi waluty nadać wartość all
( http://waluty.arkis.pl/kursy_webmaster.php?waluty=all )
i wtedy tabelka wyglądać może tak:
|
| waluta |
kurs |
1 THB |
0.1187 |
1 CAD |
2.8743 |
100 HUF |
1.0660 |
100 JPY |
2.6129 |
1 NOK |
0.3656 |
1 TRY |
0.1166 |
1 MXN |
0.1997 |
10000 IDR |
2.5479 |
1 XDR |
5.3430 |
|
| waluta |
kurs |
1 USD |
3.9989 |
1 NZD |
2.3955 |
1 CHF |
4.6144 |
1 CZK |
0.1709 |
1 SEK |
0.3759 |
1 ILS |
1.0760 |
1 ZAR |
0.2276 |
100 INR |
4.7562 |
|
|
|
| waluta |
kurs |
1 AUD |
2.6304 |
1 SGD |
3.0230 |
1 GBP |
5.1982 |
1 DKK |
0.5810 |
1 RON |
0.8715 |
100 CLP |
0.4191 |
1 BRL |
0.6941 |
100 KRW |
0.2905 |
|
|
|
| waluta |
kurs |
1 HKD |
0.5147 |
1 EUR |
4.3350 |
1 UAH |
0.0968 |
100 ISK |
2.9192 |
1 BGN |
2.2164 |
1 PHP |
0.0687 |
1 MYR |
0.9132 |
1 CNY |
0.5614 |
|
|
|
Można także całkowicie zmienić wygląd tabeli podpinają swój plik stylu (parametr style):
( http://waluty.arkis.pl/kursy_webmaster.php?archive=1&style=http://waluty.arkis.pl/arkis_waluty_style2.css )
Plik stylu standardowego można pobrać tutaj
Aby zmienić format nagłówka na krótszy, lub całkowicie go usunąć należy zmienić parametr header:
( http://waluty.arkis.pl/kursy_webmaster.php?header=1 )
|
| waluta |
kurs |
1 USD |
3.9989 |
1 EUR |
4.3350 |
1 CHF |
4.6144 |
1 GBP |
5.1982 |
1 CZK |
0.1709 |
|
Zmiana języka modułu możliwa jest po zastosowaniu parametru lang:
( http://waluty.arkis.pl/kursy_webmaster.php?lang=http://waluty.arkis.pl/lang/en.txt )
|
| currency |
rate |
1 USD |
3.9989 |
1 EUR |
4.3350 |
1 CHF |
4.6144 |
1 GBP |
5.1982 |
1 CZK |
0.1709 |
|
Pliki wzorcowe tłumaczeń można pobrać tutaj: PL
i EN (zapisać jako kodowane UTF-8).
Aby dołączyć do kodów walut flagi państw, należy dodać do wywołania parametr flag:
( http://waluty.arkis.pl/kursy_webmaster.php?flag=1 )
|
| waluta |
kurs |
 1 USD |
3.9989 |
 1 EUR |
4.3350 |
 1 CHF |
4.6144 |
 1 GBP |
5.1982 |
 1 CZK |
0.1709 |
|
I co najważniejsze dla webmaster'a, można zamieścic zestawienie kursów, nie tylko jako
IFRAME, ale także jako zwykły kod HTML, pobierając rezultat wykonania skryptu:
http://waluty.arkis.pl/kursy_webmaster.php?nohtml=1
Parametr nohtml=1 powoduje, że tabela kursów nie jest otaczana przez kody <html><body> itd.
PARAMETRY
jakie można zmieniać w wywołaniu skryptu:
| archive |
[0] - domyślny - brak linku pozwalającego wyświetlić archwalne kursy
[1] - pod tabelą kursów pojawia się link 'archiwum'. Jego kliknięcie pozwala wybrać datę dzienną
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?archive=1
|
| cols |
liczba kolumn z kursami. Domyślnie 1 kolumna.
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?cols=6
|
| flag |
[0] - domyślny - brak graficznych flag przy kodzie waluty
[1] - prezentuje graficzne flagi przy kodzie waluty
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?flag=1
|
| header |
[0] - domyślny - pokazuje długi nagłowek tabeli, czyli np. (NBP: kursy średnie walut z dnia 2014-01-16 Tabela nr 010/A/NBP/2014)
[1] - pokazuje krotki nagłowek tabeli, czyli np. (NBP: kursy średnie walut z 2012-04-24)
[2] - nie pokazuje wcale nagłówka
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?header=1
|
| lang |
ścieżka do pliku z tłumaczenień napisów w module. Brak parametru powoduje wczytanie języka
domyślnego - polskiego.
Dodatkowe informacje o budowie pliku tłumaczeń są dostępne w jego treści.
Pobierz plik języka polskiego (prawy klawiszem myszki i wybierz Zapisz element docelowy jako).
Plik musi być zakodowany w standardzie UTF-8.
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?lang=http://waluty.arkis.pl/lang/en.txt
|
| nohtml |
[0] - domyślny - tabelka otaczana jest tagami <html>, <body> itd.
[1] - tabelka nie jest otaczana tagami <html>, <body> itd. Parametr należy ustawić jeśli NIE pokazuje się tabeli kursów w IFRAME
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?nohtml=1
|
| nolink |
[0] - domyślny - nad tabelą z kursami pojawia się link do 'waluty.arkis.pl'
[1] - usuwa wiersz z linkiem do 'waluty.arkis.pl'. Ustawienie działa tylko w wersji płatnej modułu
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?nolink=1
|
| style |
ścieżka do pliku ze stylami. Jeśli go nie ma to tabelka pokazywana jest w stylu
standardowym (wygląd jak tabelki powyżej).
Pobierz styl standardowy (prawy klawisz myszki i wybierz Zapisz element docelowy jako).
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?style=http://waluty.arkis.pl/arkis_waluty_style_2.css
|
| waluty |
lista prezentowanych walut, oddzielanych przecinkami. Np.: usd,eur,gpb
Brak określenia parametru powoduje, że domyślnie prezentowane są następujące waluty: eur,usd,gbp,chf,czk,rub
Jeśli przekaże się parametr waluty=all to zaprezentowane zostaną wszystkie dostępne waluty
Dostępne waluty: aud, bgn, brl, cad, chf, clp, cny, czk, dkk, eur, gbp, hkd, hrk, huf, idr, ils, inr, isk, jpy, krw, ltl, lvl, mxn, myr, nok, nzd, php, ron, rub, sek, sgd, thb, try, uah, usd, xdr, zar
Przykład wywołania:
http://waluty.arkis.pl/kursy_webmaster.php?waluty=eur,dkk,cad,rub,sek
|
Korzystanie z modułu jest bezpłatne.
Jedynym warunkiem jest zachowanie widocznego linku prowadzącego do strony 'waluty.arkis.pl'.
Jeżeli chcą Państwo skorzystać z wersji pozbawionej linku do 'waluty.arkis.pl'.
Jeśli macie Państwo jakiekolwiek uwagi dotyczące modułu WALUTY, lub propozycje jego rozbudowy, prosimy o ich przesłanie przy
pomocy formularza kontaktowego.
|
