Wandora's Joomla Topic Reader
From WandoraWiki
(Difference between revisions)
| Line 1: | Line 1: | ||
| − | ' | + | In this article we'll go step-by-step, how set-up and use Wandora's Joomla Topic Reader module. Joomla Topic Reader module is used to publish Wandora content with Joomla content management system. Module is experimental and a general example of how to publish Wandora content in content management systems. To use this module in production environments, you probably have to modify extras provided here. To download Wandora's Joomla Topic Reader module see Extras section on [[Download|download page]]. Wandora's Joomla module is distributed under GPL v3 license. |
| − | |||
== Requirements == | == Requirements == | ||
| Line 8: | Line 7: | ||
:* Newest [[Download|Wandora]] package. | :* Newest [[Download|Wandora]] package. | ||
:* Joomla Topic Reader module (Included in Wandora source code package in extras folder). | :* Joomla Topic Reader module (Included in Wandora source code package in extras folder). | ||
| + | |||
== Setting up Joomla == | == Setting up Joomla == | ||
# Download newest [http://www.joomla.org/download.html Joomla] 1.5 installation package. | # Download newest [http://www.joomla.org/download.html Joomla] 1.5 installation package. | ||
| − | # | + | # Install Joomla by following the installation instructions included in the installation package. |
| + | |||
== Setting up Wandora == | == Setting up Wandora == | ||
| − | This | + | This section describes how to install and configure Wandora web server. |
=== Installing Wandora === | === Installing Wandora === | ||
| Line 23: | Line 24: | ||
# [[How_to_install_Wandora|Install Wandora]] | # [[How_to_install_Wandora|Install Wandora]] | ||
# [[Running_Wandora|Launch up Wandora]] | # [[Running_Wandora|Launch up Wandora]] | ||
| + | |||
=== Configuring Wandora web server === | === Configuring Wandora web server === | ||
| Line 37: | Line 39: | ||
|[[Image:Extras_drupal_wandora_server_settings_marked.png|center]] | |[[Image:Extras_drupal_wandora_server_settings_marked.png|center]] | ||
|} | |} | ||
| − | * Here there few things that interest us, mainly lines pointed by the red arrows (see the picture above). Port number indicated by top arrow is the port Wandora is going to use to output the server '''<nowiki>http://localhost:port_number/service</nowiki>'''. Below are service outputs offered by Wandora (the two red arrows below the first one), those are services we are going to use. If you scroll down the settings window, you'll see more services listed there, but only | + | * Here there few things that interest us, mainly lines pointed by the red arrows (see the picture above). Port number indicated by top arrow is the port Wandora is going to use to output the server '''<nowiki>http://localhost:port_number/service</nowiki>'''. Below are service outputs offered by Wandora (the two red arrows below the first one), those are services we are going to use. If you scroll down the settings window, you'll see more services listed there, but only the '''axis''' service is needed. |
| − | * | + | * Now test the Wandora server. Make sure you have an [[Opening_a_topic|open]] topic (For example, you can just double click '''Schema type''' in leftmost window area), then select '''Server > Start server''', if you find '''Stop server''' instead of '''Start Server''' under the '''Server''' dialog then the server is already running. |
* Finally let's test if everything works. Open up your internet browser and in location bar write '''<nowiki>http://localhost:8898/drupal_atom</nowiki>''' and hit '''Enter'''. If everything is working; you should see atom/rss feed displayed in browser. If nothing is displayed or there is an error message, then recheck Wandora Server settings and see the more in depth [[Embedded_HTTP_server|documentation]] for troubleshooting. | * Finally let's test if everything works. Open up your internet browser and in location bar write '''<nowiki>http://localhost:8898/drupal_atom</nowiki>''' and hit '''Enter'''. If everything is working; you should see atom/rss feed displayed in browser. If nothing is displayed or there is an error message, then recheck Wandora Server settings and see the more in depth [[Embedded_HTTP_server|documentation]] for troubleshooting. | ||
| + | |||
== Wandora Joomla Topic reader - Module == | == Wandora Joomla Topic reader - Module == | ||
| − | Joomla Topic reader is a module that reads topic map from Wandora by connecting SOAP service and builds a navigatable page out of it. | + | Joomla Topic reader is a module that reads topic map from Wandora by connecting to SOAP service and builds a navigatable page out of it. |
{| border="0" align="center" | {| border="0" align="center" | ||
|[[Image:joomla_topic_reader_sample.png|center]] | |[[Image:joomla_topic_reader_sample.png|center]] | ||
|} | |} | ||
| + | |||
=== Installation === | === Installation === | ||
| − | # Go to your Joomla installations administration page, from there go to Extensions -> Install/Uninstall section. | + | # Go to your Joomla installations administration page, from there go to '''Extensions''' -> '''Install/Uninstall''' section. |
| − | # Select browse from Upload Package File section and select file '''wandora_installation_folder/extras/joomla_topic_reader/plg_wantopic.zip''', click upload file and install button to install the module package. | + | # Select '''browse''' from '''Upload Package File''' section and select file '''wandora_installation_folder/extras/joomla_topic_reader/plg_wantopic.zip''', click '''upload file and install''' button to install the module package. |
{| border="0" align="center" | {| border="0" align="center" | ||
| Line 61: | Line 65: | ||
=== Configuration === | === Configuration === | ||
| − | # From Joomla Administration page go to Module Manager section. | + | # From '''Joomla Administration''' page go to '''Module Manager''' section. |
# There search for module named Wandora Topic Map Reader and edit it. | # There search for module named Wandora Topic Map Reader and edit it. | ||
# In module editing page enable the Wandora Topic Map Reader | # In module editing page enable the Wandora Topic Map Reader | ||
| − | # You can also configure the module in this page. Here you can | + | # You can also configure the module in this page. Here you can modify three settings; show instances only, default topic subject identifier and the SOAP client path. |
| − | # | + | # Option show instances, when enabled makes the module only display the instances of topic, taking only small amount space, otherwise the whole topic is shown with all it's properties. |
| − | # Default topic subject identifier specifies default topic the module loads. Change the subject identifier here to the topic which you want to | + | # Default topic subject identifier specifies default topic the module loads. Change the subject identifier here to the topic which you want to be opened by default. |
# SOAP client path is axis server path from Wandora which by default is '''<nowiki>http://localhost:8898/axis</nowiki>''' | # SOAP client path is axis server path from Wandora which by default is '''<nowiki>http://localhost:8898/axis</nowiki>''' | ||
| Line 73: | Line 77: | ||
|[[Image:joomla_topic_reader_params.png|center]] | |[[Image:joomla_topic_reader_params.png|center]] | ||
|} | |} | ||
| + | |||
=== Customization === | === Customization === | ||
To modify the background color of the generated tables: | To modify the background color of the generated tables: | ||
| − | :* Open ''' | + | :* Open '''joomla_topic_reader_folder/tmpl/default.css''' file |
| − | :* Modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''. | + | :* Modify for your liking the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''. |
| + | |||
=== Usage === | === Usage === | ||
To display any output make sure that module is enabled and it is set to a visible position. Also make sure that Wandora server is up and running. | To display any output make sure that module is enabled and it is set to a visible position. Also make sure that Wandora server is up and running. | ||
Revision as of 11:33, 4 January 2010
In this article we'll go step-by-step, how set-up and use Wandora's Joomla Topic Reader module. Joomla Topic Reader module is used to publish Wandora content with Joomla content management system. Module is experimental and a general example of how to publish Wandora content in content management systems. To use this module in production environments, you probably have to modify extras provided here. To download Wandora's Joomla Topic Reader module see Extras section on download page. Wandora's Joomla module is distributed under GPL v3 license.
Contents |
Requirements
Setting up Joomla
- Download newest Joomla 1.5 installation package.
- Install Joomla by following the installation instructions included in the installation package.
Setting up Wandora
This section describes how to install and configure Wandora web server.
Installing Wandora
- Please see Wandora system requirements first
- Download the newest Wandora package
- Install Wandora
- Launch up Wandora
Configuring Wandora web server
- Launch up Wandora if you haven't already
- For testing purposes open any topicmap in Wandora. Inside Wandora select File > Open project... or Ctrl+L. From file browser navigate to Wandora installation folder > samples > ArtOfNoise > ArtOfNoise.wpr Open ArtOfNoise.wpr
|
- Select Server > Server settings.... A popup should open; here you can adjust Wandora's HTTP Server settings
 |
- Here there few things that interest us, mainly lines pointed by the red arrows (see the picture above). Port number indicated by top arrow is the port Wandora is going to use to output the server http://localhost:port_number/service. Below are service outputs offered by Wandora (the two red arrows below the first one), those are services we are going to use. If you scroll down the settings window, you'll see more services listed there, but only the axis service is needed.
- Now test the Wandora server. Make sure you have an open topic (For example, you can just double click Schema type in leftmost window area), then select Server > Start server, if you find Stop server instead of Start Server under the Server dialog then the server is already running.
- Finally let's test if everything works. Open up your internet browser and in location bar write http://localhost:8898/drupal_atom and hit Enter. If everything is working; you should see atom/rss feed displayed in browser. If nothing is displayed or there is an error message, then recheck Wandora Server settings and see the more in depth documentation for troubleshooting.
Wandora Joomla Topic reader - Module
Joomla Topic reader is a module that reads topic map from Wandora by connecting to SOAP service and builds a navigatable page out of it.
 |
Installation
- Go to your Joomla installations administration page, from there go to Extensions -> Install/Uninstall section.
- Select browse from Upload Package File section and select file wandora_installation_folder/extras/joomla_topic_reader/plg_wantopic.zip, click upload file and install button to install the module package.
 |
Configuration
- From Joomla Administration page go to Module Manager section.
- There search for module named Wandora Topic Map Reader and edit it.
- In module editing page enable the Wandora Topic Map Reader
- You can also configure the module in this page. Here you can modify three settings; show instances only, default topic subject identifier and the SOAP client path.
- Option show instances, when enabled makes the module only display the instances of topic, taking only small amount space, otherwise the whole topic is shown with all it's properties.
- Default topic subject identifier specifies default topic the module loads. Change the subject identifier here to the topic which you want to be opened by default.
- SOAP client path is axis server path from Wandora which by default is http://localhost:8898/axis
 |
Customization
To modify the background color of the generated tables:
- Open joomla_topic_reader_folder/tmpl/default.css file
- Modify for your liking the background-color and/or border parameters in these classes: .subtitle, .type and .cell.
Usage
To display any output make sure that module is enabled and it is set to a visible position. Also make sure that Wandora server is up and running.
