--=REKLAMA=--

Pomoc25

Rozszerzenia Zarządzanie modułami Wpinacz

Z Joomla!WikiPL

Moduł Wpinacz

Moduł Wpinacz [Wrapper] - podobnie jak komponent - wyświetla w ramce pływającej dowolną inną stronę lub witrynę internetową z całym jej interfejsem albo niestandardową, niezależną od Joomla! aplikację, nieobsługiwaną w zwykłym trybie np. stronę dHTML, galerię, katalog. Jeśli umieszczona w module strona jest szersza lub wyższa niż moduł, można uaktywnić paski przewijania. Przykład modułu przedstawia ilustracja poniżej:

Przykład zastosowania modułu Wpinacz

Powiązania z innymi składnikami Joomla

Moduł Wpinacz nie jest połączony z żadnym innym komponentem (jak to się dzieje np. w przypadku modułów Reklama czy Tematy pokrewne.

Konfiguracja modułu

Opcje podstawowe

Opcje podstawowe w ustawieniach modułu Wpinacz

  • Adres internetowy [Web URL]: decyduje o wyświetlaniu adresu witryny internetowej. Zaznacz jedną z opcji: Pokaż lub Ukryj.
  • Dodaj automatycznie [Auto Add]: decyduje o automatycznym uzupełnieniu adresu o protokół. Zaznacz jedną z opcji: Tak lub Nie. Jeśli w adresie URL nie zostanie wykryty protokół http:// lub https:// domyślnie zostanie dodane http://.
  • Paski przewijania [Scroll Bars]: decyduje o wyświetlaniu pasków przewijania - poziomego i pionowego - w przypadku, gdy rozmiar strony lub okna aplikacja będzie większy niż rozmiar. Jeśli wybierzesz Tak, paski przewijania są widoczne zawsze. Jeśli ustawisz Nie, paski przewijania nie zostaną wyświetlone, nawet gdy zawartość wykraczać będzie poza ustalony obszar. Jeśli wybierzesz opcję Auto, paski przewijania będą wyświetlane w razie potrzeby.
  • Szerokość [Width]: szerokość ramki. Możesz podać wartość bezwzględną - w pikselach bądź relatywnie - procent szerokości obszaru, w którym ramka została umieszczona, np. głównego obszaru prezentacji na stronie albo modułu. Jeśli ustalasz wartość procentową, dodaj jednostkę %. To ustawienie może przynieść nieoczekiwane rezultaty, np. w przypadku ilustracji bądź ramek pływających. Przykładowo, gdy wpiszesz 550, ramka będzie mieć szerokość 550 pikseli, gdy wpiszesz 75%, to w przypadku modułu będzie to zwykle w granicach 150 pikseli, a w głównym obszarze prezentacji w granicach 600-1000px.
  • Wysokość [Height]: wysokość ramki. Możesz podać wartość bezwzględną - w pikselach bądź relatywnie - procent wysokości obszaru, w którym umieszczono ramkę, np. w obszarze prezentacji głównej treści albo modułów. Jeśli ustalasz wartość procentową, dodaj jednostkę %. To ustawienie może przynieść nieoczekiwane rezultaty. Przetestuj dokładnie efekt.
  • Dopasuj wysokość [Auto Height]: decyduje o automatycznym ustaleniu wysokości strony zewnętrznej. Zaznacz jedną z opcji Tak lub Nie. Opcja Tak może nie działać w pełni poprawnie w przypadku stron spoza Twojej domeny. Jeśli zobaczysz błąd JavaScript, upewnij się, że ta funkcja jest wyłączona. Niekompatybilne z XHTML.
  • Cel [Target Name]: podaj nazwę ramki pływającej. Opcjonalne. Nazwa ramki może posłużyć jako cel w odnośnikach do strony.

Opcje rozszerzone

Zestaw opcji rozszerzonych obejmuje cztery ustawienia powtarzające się w wielu modułach:

Opcje rozszerzone w ustawieniach modułu Wpinacz

  • Alternatywny układ [Alternative Layout]: rozwijalna lista układów decydujących o sposobie prezentacji treści modułu. Możesz wybrać listy inny układ, niż domyślny - jeśli istnieje (spośród dostarczonych z modułem albo nadpisanych w szablonach witryny).
  • Przyrostek klas CSS modułu [Module Class Suffix]: umożliwia nadanie modułowi wyglądu odróżniającego go od innych, jeśli w arkuszu CSS istnieją odpowiednie deklaracje stylów. Wpisz przyrostek nazwy klas albo klasę modyfikującą standardowe reguły formatowania modułu. W przypadku nazwy klasy poprzedź ją spacją (odstępem).
  • Pamięć podręczna [Caching]: decyduje o przechowywaniu treści modułu w pamięci podręcznej, a tym samym o zmniejszeniu ilości zapytań do bazy danych, co przyspiesza wysyłanie stron do przeglądarek oraz ogranicza obciążenie serwera. Ustawienia globalne pamięci podręcznej określane są na stronie Witryna: Konfiguracja. Wybierz jedną z opcji: Globalne albo Nie przechowuj.
  • Czas przechowywania [Cache Time]: określa w sekundach czas, jaki musi upłynąć między odświeżeniem plików przechowywanych w katalogu pamięci podręcznej. Ustal, zależnie od częstotliwości wprowadzania zmian w treści witryny.

Umieszczenie modułu na stronach witryny

Aby umieścić moduł Wpinacz na stronie, wykonaj następujące czynności:

  1. Zaloguj się do części administracyjnej co najmniej jako administrator.
  2. Z głównego menu zaplecza wywołaj stronę Rozszerzenia/Moduły.
  3. W przyborniku kliknij ikonę Utwórz, aby przejść na stronę umożliwiającą wybór typu modułu, który chcesz umieścić na stronie.
  4. Na liście wyboru typu kliknij nazwę Wpinacz, by rozpocząć konfigurację modułu.
  5. Skonfiguruj podstawowe dane modułu w sekcji Szczegóły:
    Podstawowe dane modułu Wpinacz
    • Wpisz tytuł modułu. Jest wymagany.
    • Zdecyduj, czy wyświetlać tytuł modułu. Zaznacz Pokaż lub Ukryj.
    • Ustal położenie modułu na stronie, wybierając jedną z dostępnych pozycji. Jeśli znasz nazwę pozycji, możesz ją również wpisać.
    • Zdecyduj, czy włączyć moduł (opublikować).
    • Możesz ustalić terminy rozpoczęcia publikacji modułu i wyłączenia z publikacji.
    • Zdecyduj, jaki poziom dostępu jest wymagany, aby zobaczyć moduł. Wybierz jeden z poziomów dostępu z rozwijalnej listy. Zwykle: Powszechny - wszyscy. Możesz zmienić poziom dostępu do modułu. Jeśli wybierzesz poziom wyższy, niż powszechny, moduł będzie widoczny tylko dla zalogowanych użytkowników, przypisanych do grup, którym przypisano wybrany poziom dostępu.
    • Możesz określić kolejność wyświetlania modułu w wybranej pozycji. Domyślnie nowo tworzone moduły wyświetlane są jako ostatnie. Aby ustalić inną kolejność, kliknij najpierw w przyborniku ikonę Zapisz. W efekcie na liście rozwijalnej Porządek powinny się pojawić tytuły umieszczonych w tej pozycji modułów. Zaznacz tytuł modułu, przed którym chcesz umieścić tworzony moduł. Jeśli ta metoda nie przyniesie spodziewanego efektu, kolejność modułów można zmienić na stronie przeglądu modułów.
    • Możesz ustalić daty rozpoczęcia i zakończenia publikacji modułu z dokładnością co do minuty. Wybierz je z kalendarzyka lub wpisz. Wpisując, zachowaj format RRRR-MM-DD GG:MM:SS.
    • Jeśli wydajesz witrynę wielojęzyczną, określ, czy wyświetlać moduł na stronach wszystkich języków, czy jednego z wybranych.
  6. Ustal, na których stronach witryny wyświetlać moduł, przypisując go do wybranych lub wszystkich pozycji menu:
    Sekcja Przypisz do pozycji menu w module Własny HTML
    • Najpierw określ zasadę przypisania: Na wszystkich stronach, Na żadnej stronie, Tylko na zaznaczonych stronach, Na wszystkich poza zaznaczonymi.
    • Następnie klikaj karty dostępnych menu i zaznaczaj pola wyboru przy nazwach pozycji menu.
      Uwaga: Korzystając z przycisków obok etykiety Zaznacz menu, możesz spowodować, że zostaną zaznaczone wszystkie pozycje lub przełączyć zaznaczenie (niezaznaczone zostaną zaznaczone i odwrotnie). Możesz również wyczyścić zaznaczenie.
  7. Dostosuj domyślne opcje modułu do swoich potrzeb:
    • przede wszystkim podaj adres internetowy zasobu, który chcesz prezentować w module,
    • określ szerokość i wysokość obszaru modułu (np. gdy publikujesz moduł nad lub pod treścią główną albo w artykule,
    • jeśli trzeba, skonfiguruj opcje rozszerzone.
  8. Aby zachować ustawienia, kliknij w przyborniku ikonę Zapisz.

Porada:

Moduł Wpinacz najlepiej umieszczać nad lub pod treścią główną, aby mu zapewnić wystarczająco szeroki obszar prezentacji. Zważ, że jeśli umieścisz moduł w bocznym, niezbyt szerokim pasku, okno prezentacyjne będzie niewielkie, zwłaszcza, że najpewniej zostanie zwężone o szerokość paska przewijania (ok. 20px).

Pliki modułu

Moduł Wpinacz jest obsługiwany przez zestaw skryptów umieszczonych w katalogu modules/mod_wrapper. Nazwa podkatalogu katalogu jest systemową nazwą typu modułu (w Joomla 1.6 i wyższych, inaczej niż w poprzednich wydaniach jest na zapleczu tłumaczona). Moduł Wpinacz i wszystkie jego kopie są więc modułami typu mod_wrapper.

Własne układy prezentacji

Aby zmodyfikować sposób prezentacji modułu Wpinacz, można skorzystać z techniki alternatywnych układów definiowanych w szablonie witryny. W tym celu w folderze html utworzonym w katalogu domyślnego szablonu witryny tworzymy podkatalog mod_wrapper i kopiujemy do niego z katalogu modules/mod_wrapper/tmpl plik default.php, następnie zmieniamy mu nazwę na własną (!). Nazwa nie może zawierać znaków podkreślenia (_).

Modyfikując kod html w tym pliku można zmienić sposób prezentacji modułu. Nowy układ będzie dostępny w opcjach rozszerzonych na rozwijalnej liście układów alternatywnych - nazwą układu będzie nazwa pliku (bez rozszerzenia .php).

Nazwę można "przetłumaczyć", umieszczając odpowiednie deklaracje w pliku językowym szablonu.

Uwaga: Jeśli w witrynie używasz kilka szablonów, pamiętaj, aby pliki własnych układów modułu przekopiować do katalogów wszystkich używanych szablonów.