Twitter Status plugin dla Joomla! 1.5 wersja 1.1 Autor: Tomasz Dobrzyński Data: 26/12/2007 1
Spis treści Licencja... 3 Czym jest Twitter?...3 Opis wtyczki... 3 Jak to dział a?... 3 Instalacja i Konfiguracja...4 Warstwa uż ytkownika... 6 2
Licencja Ta dokumentacja jest wydana pod licencją Joomla! Electronic Documentation License v 1.0. Czym jest Twitter? Twitter (Twitter.com) is a serwisem mini bloggerowym, pozwalającym na stały kontakt z przyjaciółmi, rodziną, współpracownikami za pomocą krótkich 140 znakowych opisów. Opis wtyczki "Twitter Status" dodaje nowy status gdy zostanie dodany nowy artykuł. Jak to działa? Kiedy autor artykułu naciśnie przycisk Save znajdujący się na stronie "Add Article", wtyczka połączy się z serwisem twitter.com i przekaże tytuł artykułu. Jeśli wszystko pójdzie w porządku, na swoim koncie Twitter ujrzysz nowy status. Jak już wiesz, Twitter posiada ograniczenia co do maksymalnej długości tekstu (140 znaków). Czasami rozmiar tytułu może przekroczyć 140 znaków. Jeśli tak się stanie, wtyczka obetnie tytuł. Twitter Status pracuje w dwóch warstwach warstwie Administratora (zaplecze) warstwie Użytkownika (witryna) Jeśli wybrałeś z ustawień personalych opcję Enable Twitter, wtyczka zaktualizuje status wpisanego tam konta. Jeśli nie zaznaczyłeś tej opcji, wtyczka zaktualizuje status konta systemowego (z konfiguracji wtyczki) Przejdź do rozdziału Warstwa użytkownika, aby dowiedzieć się więcej. 3
Instalacja i Konfiguracja Pobierz wtyczkę ze strony Joomla! Extensions Directory. Używając menedżera Install/Uninstall (menu Extension) zainstaluj pobrany plik. Ekran instalacji wtyczki Jeśli wszystko pójdzie w porządku, zobaczysz następujący komunikat: W niektórych przypadkach możesz ujrzeć następującą wiadomość: bardzo możliwe, że ujrzysz tą wiadomość jeśli nie posiadasz zainstalowyanych innych niż angielskich lokalizacji językowych (w tym przypadku polskiej). Powinieneś zignorować ten komunikat. Teraz musisz włączyć oraz skonfigurować wtyczkę. Zaznacz pole wyboru przy System Twitter status, a następnie naciśnij na przycisk Edit. Ujrzysz następujący ekran: 4
Ekran konfiguracji wtyczki Zaznacz pole Yes przy opcji Enable z Detail box. Teraz możesz przystąpić do konfiguracji. Jak widzisz, jest tu 5 opcji: Username: Login do konta na Twitter.com Password: Hasło do konta na Twitter.com Selected sections: Możesz wpisać tu wybrane numery ID sekcji, z których Twitter będzie mógł tworzyć statusy. Jeśli chciałbyś załączyć wszystkie sekcje, pozostaw to pole puste. Kiedy wpiszesz więcej niż jeden numer ID, musisz oddzielić je przecinkami (bez spacji przed i za). Selected categories: Możesz wpisać tu wybrane numery ID kategorii, z których Twitter będzie mógł tworzyć statusy. Jeśli chciałbyś załączyć wszystkie kategorie, pozostaw to pole puste. Kiedy wpiszesz więcej niż jeden numer ID, musisz oddzielić je przecinkami (bez spacji przed i za). Attaching URL to status: Wybierz tą opcję jeśli do statusu chciałbyś dołączyć skrócony za pomocą TinyURL adres artykułu (Format: Title of article http://tinyurl.com/dud23). Enable User Layer: Możesz wybrać, czy warstwa użytkownika będzie dostępna dla Twittera; strona (User Detail). Jeśli opcja zostanie wyłączona, statusy będą aktualizowane na koncie systemowym, gdyż dane użytkowników nie będą uwzględniane przy wczytywaniu konfiguracji. Uwaga! Powinieneś pamiętać, że obie opcje: Selected sections i Selected categories zależą od siebie Kliknij przycisk Save by wyjść. Wtyczka jest teraz aktywna! 5
Warstwa użytkownika Twitter Status pracuje także w warstwie użytkownika. Jeśli posiadasz możliwość tworzenia nowych artykułów, masz możliwość aktualizowania własnego statusu Twitter. Jeśli chcesz włączyć warstwę użytkownika na twoim serwerze, pobierz wtyczkę UserMeta System Plugin. Jeśli już ją zainstalowałeś i włączyłeś, idź do joomla_root/administrator/plugins/system/usermeta. Otwórz plik user.xml. Będzie on wyglądał następująco: <?xml version="1.0" encoding="utf-8"?> <form> <params> <param name="admin_language" type="languages" client="administrator" default="" label="back-end Language" description="paramadminlanguage" /> <param name="language" type="languages" client="site" default="" label="front-end Language" description="paramlanguage" /> <param name="editor" type="editors" default="" label="user Editor" description="wysywyg Editor for this User" /> <param name="helpsite" type="helpsites" default="" label="help Site" description="help Site for this User" /> <param name="timezone" type="timezones" default="" label="time Zone" description="time Zone for this User" /> </params> </form> Dołącz podświetlony tekst do pliku (tekst musi znajdować się w znacznikach <params></params>) <?xml version="1.0" encoding="utf-8"?> <form> <params> <param name="admin_language" type="languages" client="administrator" default="" label="back-end Language" description="paramadminlanguage" /> <param name="language" type="languages" client="site" default="" label="front-end Language" description="paramlanguage" /> <param name="editor" type="editors" default="" label="user Editor" description="wysywyg Editor for this User" /> <param name="helpsite" type="helpsites" default="" label="help Site" description="help Site for this User" /> <param name="timezone" type="timezones" default="" label="time Zone" description="time Zone for this User" /> <param name="twitter_active" type="radio" default="0" label="enable Twitter:" description="when you enable, title of article and url address will be send on your Twitter account!"> <option value="1">yes</option> <option value="0">no</option> </param> <param name="twitter_login" type="text" size="40" label="twitter username:"/> <param name="twitter_password" type="password" size="40" label="twitter password:"/> </params> </form> Teraz autor artykułu może zadecydować, czy status będzie aktualizowany na jedgo, czy systemowym koncie Twitter. jeśli jesteś jednym z autorów idź do Your Details : Element Menu z podświetloną pozycją Your Details 6
Jeśli poprawnie wprowadziłeś powyższe dane do pliku user.xml, ujrzysz następujący ekran: Ekran strony Your Details Możesz ujrzeć tu 3 zmienne: Enable Plugin: możesz wybrać tutaj czy tytuł artykułu będzie wysyłany na konto zdefiniowane poniżej, czy systemowe (skonfigurowane podczas procesu instalacyjnego wtyczki). Jeśli zaznaczyłeś Yes, wtyczka zaktualizuje twoje konto (z danych poniżej). Twitter username: login do twojego konta na Twitter.com Twitter password: hasło do twojego konta na Twitter.com Kliknij przycisk Save, by wyjść. Teraz wtyczka jest w pełni gotowa do pracy z użytkownikiem. 7