Edocs: Prosty, sprytny i efektywny sposób osadzania dokumentów w artykułach Drukuj
Ocena użytkowników: / 0
SłabyŚwietny 
Wpisany przez Jan Jackowicz-Korczyński   
wtorek, 23 marca 2010 13:51
Dodatek wykorzystuje przeglądarkę Google Dokumentu (Google Docs Viewer). Umożliwia osadzanie, przeglądanie i udostępnianie do pobrania dokumentów w różnych formatach.
Dostępne formaty (wszystkie, jakie można dodać Google):

PDF | DOC (Word, Openoffice) | PPT (Powerpoint) | XSL (Excel)
 
 
Niniejszy opis jest cytetem z polskiej wersji opisu tego dodatku wyświetlającej się bezpośrednio po jego instalacji.


Jak z tego korzystać?

Bardzo łatwo osadzić jakiś dokument w artykule. Wystarczy umieścić w nim następujący kod::

{edocs}folder/sciezka/dokument.format,szerokosc,wysokosc{/edocs}

Przykład:








Jeśli chcesz udostępnić łącze do pobrania dokumentu, dodaj do poprzedniego kodu parametr "link"





Pobierz

Aby zmienić standardowy tekst odnośnika, popraw parametr "Etykieta odnośnika Pobierz" w ustawieniach dodatku.

UWAGA: Dodatek edocs zakłada domyślnie, że dokumenty umieszczone w folderze lub podkatalogu images/stories. Wszystko, co dodasz do standardowego kodu, zostanie dodane do tej domyślnej ścieżki dostępu. Aby zmienić domyślną ścieżkę dostępu, popraw parametr "Główny katalog dokumentów" w ustawienaich dodatku.


Wskazówki i sztuczki

Poza katalogiem domyślnym

Aby ominąć domyślny główny katalog dokumentów, wystarczy w ścieżce dokumentu dodać prawy ukośnik "/"

Przykład:

Jeśli użyjesz domyślnego kodu:





, to dokument będzie poszukiwany pod adresem http://www.twojadomena.com/images/stories/sciezka/dokument.pdf, ponieważ zgodnie z ustawieniem parametru "Główny katalog dokumentów" w katalogu images/stories edocs rozpoczyna poszukiwanie dokumentu.

Jeśli użyjesz nowego kodu - z prawym ukośnikiem na początku:



(zwróć uwagę na ukośnik na początku!),

adres dokumentu będzie w rezultacie następujący http://www.twojadomena.com/dokumenty/sciezka/dokument.pdf

Zewnętrzne dokumenty

Aby osadzić zewnętrzny dokument, trzeba podać jego pełny adres.

Przykład:





Stylizacja osadzanych dokumentów

Każdy osadzany dokument umieszczany jest wewnątrz elementu DIV. Jeśli potrzebujesz dodatkowej kontroli wyglądu wszystkich osadzonych dokumentów, zastosuj klasę "edocs_viewer".

Jeśli potrzebujesz zmodyfikować wygląd pojedynczego dokumentu, możesz zastosowac identyfikator wyjątku dla pojemnika div. Aby to uczynić, dodaj kolejny - czwarty parametr w kodzie osadzającym dokument.

Oto kod:



Ijeśłi nie chcesz umieszczać odnośnika Pobierz, wpisz kod



! Zwróc uwagę na dwukrotnie powtórzony przecinek.

Gdy coś nie wychodzi...

Jeśli wpiszesz poprawny kod, ale nie osiągasz spodziewanego rezultatu, włącz tryb diagnostyczny dodatku. Następnie przejdź do artykułu zobacyć adres, pod którym dodatek szuka dokumentu. Dzięki temu poprawisz błednie wpisaną ścieżkę.

 

POBIERANIE DAODATKU:

Pakiet instalacyjny zawsze najlepiej pobierać z witryny producenta, na której znajdziesz również prezentację zdolności dodatku.

Świeżutką polską wersję można pobrać z  katalogu rozszerzeń POLSKIEGO CENTRUM JOOMLA, a prezentację zobaczyć na odnowionej witrynie demo.joomla.pl

 

Wsparcie i aktualizacje

Aby sprawdzić, czy jest nowa wersja dodatku, a także by uzyskać pomoc, odwiedź stronę projektu
http://www.mediaeventi.it/en/projects/joomla/edocs