--=REKLAMA=--

Dyskusja

Konfiguracja serwera pomocy

Z Joomla!WikiPL

Oryginał

What are help screens?

Ikona pomoc.png

Na wszystkich stronach zaplecza administracyjnego mamy dostęp do pomocy podręcznej, tzw. ekranów pomocy. Aby uzyskać dostęp do ekranu pomocy, naciskasz ikonę Pomoc [Help] w przyborniku, w prawym górnym rogu ekranu. Każdy ekran pomocy zawiera informacje dotyczące strony, na której aktualnie przebywasz. W Joomla 1.5 możesz także wybrać z menu polecenie Pomoc → Ekrany pomocy [Help → Joomla! Help], aby przejść na stronę prezentującą ekrany pomocy w porządku alfabetycznym. Na liście mogą się znaleźć również ekrany pomocy dodane przez instalowane dodatkowo komponenty.

Standardowo ekrany pomocy pobierane są ze zdalnego oficjalnego serwera pomocy - joomla.org. Konfiguracja globalna pozwala jednak zmienić adres serwera, tak aby pobierać je z serwera lokalnego albo z serwera [www.joomla.pl Polskiego Centrum Joomla]

Ekrany pomocy to zestaw instrukcji dla administratorów i operatorów Joomla!. Nazwane zostały „ekranami pomocy”, ponieważ każdy artykuł stanowi objaśnienie dla jednego z ponad 150 okien - ekranów, z jakimi na co dzień spotykają się administratorzy Joomla! Instrukcje te są również dołączone do polskiego wydania Joomla!.


What is a local help server?

Lokalny serwer pomocy Joomla! udostępnia takie same (lub podobne), ekrany pomocy jak domyślny serwer pomocy znajdujący się pod adresem help.joomla.org. Lokalny serwer pomocy warto skonfigurować z kilku powodów. Na przykład, może chcesz

  • serwować ekrany pomocy z lokalnego serwera intranetowego zamiast z help.joomla.org.
  • dostosować wygląd ekranów pomocy do swoich wymagań, np. dodać logo firmy albo zastosować szablon pasujący do zmienionego wyglądu zaplecza
  • użyć angielskich ekranów pomocy jako punktu wyjścia do tłumaczenia ekranów pomocy na inny język.

Wadą prowadzenia własnego lokalnego serwera pomocy jest to, że od czasu do czasu trzeba aktualizować treść ekranów pomocy, a także konieczność utrzymywania dodatkowej witryny.

Setting up a local help server

Krok 1: Installing Joomla! 1.0 to use as a local help server

Ważna uwaga: Instrukcje zamieszczone poniżej objaśniają, jak skonfigurować lokalny serwer pomocy, udostępniający ekrany dla instalacji Joomla 1.5. Zwróć uwagę, że lokalny serwer pomocy jest skonfigurowany na Joomla 1.0. Można wprawdzie skonfigurować lokalny serwer pomocy na Joomla 1.5, ale pliki zrzutów SQL w formacie dla Joomla 1.5 są jeszcze niedostępne.

Setting up a local help server is similar to installing Joomla! on your site. There is one major difference in the installation process though. In a normal Joomla! installation you would normally check the box “Install Sample Data” but when setting up a help server, do not be check this box off.

Important: Note the MySQL Table Prefix and the MySQL Database Name used when installing the Joomla! local help server. You will need to know these later.

Complete the installation process as normal. When you have finished the installation process you will need to delete the <joomla-root>/installation directory.


Krok 2: Pobierz najnowszą wersję ekranów pomocy

Pobierz najnowszą wersję ekranów pomocy ze centralnego repozytorium JoomlaCode [1]

Zwróć uwagę, że data stanowi część nazwy pliku - upewnij się, że pobierasz najnowszą wersję.

Krok 3: Rozpakuj pliki do lokalnego katalogu

Rozpakuj paczkę pobraną z JoomlaCode do katalogu na swoim komputerze lokalnym. Po rozpakowaniu będziesz mieć w katalogu następujące pliki:

Nazwa pliku Opis
category.txt.sql zawiera zrzut SQL tabeli kategorie (jos_categories)
content.txt.sql zawiera zrzut SQL tabeli content (jos_content)
menu.txt.sql zawiera zrzut SQL tabeli menu (jos_menus)
modules.txt.sql zawiera zrzut SQL tabeli modules (mos_modules)
readme.txt zawiera zwięzły opis ekranów pomocy
section.txt.sql zawiera zrzut SQL tabeli sections (jos_sections)
images.zip zawiera wszystkie zrzuty ekranów, pasków narzędzi i ikon używanych w ekranach pomocy

Krok 4: Rozpakuj plik z grafikami

One of the files you just extracted was images.zip. This contains all the screenshots, tool bar images and icons used in the help screens. Either:

  • Extract it to a directory on your local computer, then upload all the files into the <joomla-root>/images/stories directory of your help server.
  • Or upload the images.zip to your help server and extract it into the <joomla-root>/images/stories directory using the server control panel or a command-line instruction in an SSH session. This method requires appropriate access to your help server.

Once the upload is complete you should have the following directory structure:

<joomla-root>
 +- images
     +- stories
         +- help_screens_1.5
             +- buttons
             +- headers
             +- icons
             +- screenshots
             +- toolbars
             +- userlevels

Step 5: Amend the database scripts

The default MySQL Table Prefix for a Joomla! 1.0 installation is jos_. If your MySQL Table Prefix (which you noted in Step 1) is not jos_ then you will need to amend all five of the .txt.sql files before they can be used. To amend the files, open each one in turn using a text editor. Do not use a word processing program. Using the Find and Replace or similar function, replace all instances of jos_ with your MySQL Table Prefix. Repeat this for all five files.

Step 6: Start phpMyAdmin

Open phpMyAdmin or a similar MySQL database management tool. Navigate to the database used by your Joomla! local help server. Go to the Import page.

Step 7: Import the data

Browse to each of the .txt.sql files and click the Go button. Repeat this process for each file in turn. The order in which you import them does not matter.

Plik:CreatingLocalHelpServerPHPMyAdminFileToImport.png

This completes the process of setting up your local help server.

Step 8: Test

Go to the front-end of your local help site. You should see a new menu item called Help Screens. If you click on it the menu should open up and you should see the following sub-menus:

Joomla! 1.5.x Help Screens: General
Joomla! 1.5.x Help Screens: Site
Joomla! 1.5.x Help Screens: Menus Menu
Joomla! 1.5.x Help Screens: Content Menu
Joomla! 1.5.x Help Screens: Components Menu
Joomla! 1.5.x Help Screens: Extensions Menu
Joomla! 1.5.x Help Screens: Tools Menu

Try clicking on some of these items and make sure that the help screens are displaying correctly. In particular, check that the screenshots and other images are being shown. If they are not then check the directory structure in the <joomla-root>/images/stories directory as it is important that this is set up correctly.

Configuring Joomla! 1.5 to use your local help server

Step 1: Edit the help server list

The list of available help servers is stored in XML format in the file <joomla-root>/administrator/help/helpsites-15.xml. Open this file in a text editor and add the following line in the <sites> segment (replacing the url attribute with the URL of your local help server):

   	<site tag="en-GB" url="http://localhost/joomlahelp">Local Help</site>

For example, when this line is added to the standard helpsites-15.xml file distributed with Joomla! 1.5 it will look like this:

<?xml version="1.0" encoding="iso-8859-1"?>
<joshelp>
<sites>
   	<site tag="en-GB" url="http://help.joomla.org">English (GB) - help.joomla.org</site>
   	<site tag="en-GB" url="http://localhost/joomlahelp">Local Help</site>
</sites>
</joshelp>

Save the file.

Step 2: Change Global Configuration

Log into the Joomla! Back End of your Joomla! 1.5 site, not the local help server.

Go to Site -> Global Configuration. Click on the System tab. Find the System Settings group and within that the Help Server field. This is a drop-down selection list. Click on it and select your new local help server from the list.

Save your changes to Global Configuration.

Step 3: Test

Go to any screen in the Joomla! Back End and click on the Help toolbar button. You should see the appropriate help screen in a popup window, served from your local help server.

As multiple Joomla! 1.5 sites can share the same local help server, you will need to repeat these steps for each Joomla! 1.5 site.


This page was adapted from an original document produced during the GHOP Contest by igeoffi.

Dziękujemy za wkład

» Stefan Wajda [zwiastun],