File:Topic export batch process.png

2011-06-16T12:10:18Z

Elias.tertsunen:

Topic Map Export for Drupal

2011-06-16T12:08:49Z

2011-06-16T10:51:53Z

Elias.tertsunen:

In this article we'll go step-by-step, how set-up and use Wandora's Drupal extra modules. Drupal modules are used to publish Wandora content in Drupal content management system. Modules are experimental and a general example of how to publish Wandora content in content management systems. To use modules in production environments, you probably have to modify extras provided here. To download Wandora's Drupal modules see Extras section on [[Download|download page]]. Wandora's Drupal extra modules are distributed under GPL v3 lisence.

== Requirements ==

:* A working [http://drupal.org/project/drupal Drupal] 7 installation.
:* Newest [[Download|Wandora]] package.
:* Drupal extra modules (Included in Wandora source code package in extras folder).

== Setting up Drupal ==
Since this does not belong to the scope of this article, this will be described in very few steps:
# Download newest [http://drupal.org/project/drupal Drupal] 7 installation package.
# Create mysql database and user with full privileges to the database.
# Extract Drupal to your desired web directory
# Navigate from your internet browser to the path where you have extracted drupal
# Follow the installation procedure and fill out the forms.
# Drupal should be now installed! If any problems occurred please refer to the [http://drupal.org/getting-started/install full installation manual].

For complete description of the installation procedure go [http://drupal.org/getting-started/install here], for testing purposes it is recommended that you put up a local server setup.

== Setting up Wandora ==

This chapter describes how to install and configure Wandora web server.

=== Installing Wandora ===

# Please see Wandora [[System_requirements|system requirements]] first
# [[Download|Download]] the newest Wandora package
# [[How_to_install_Wandora|Install Wandora]]
# [[Running_Wandora|Launch up Wandora]]

=== Configuring Wandora web server ===

* [[Running_Wandora|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

{| border="1" align="center"
|[[Image:Extras_drupal_open_wandora_project.png]]
|}

* Select '''Server > Server settings...'''. A popup should open; here you can adjust Wandora's HTTP Server settings
{| border="0" align="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://127.0.0.1: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 these three services are needed: '''axis''', '''drupal_atom''', and '''rss'''.
* Let's 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://127.0.0.1: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 Drupal Modules ==

=== Installation ===
# Extract the contents '''wandora_installation_folder/extras/drupal/wandora_drupal_7.zip''' and copy/upload the '''wandora''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora module and any of it's submodules you wish to use in Drupal (in the '''Modules''' section or alternatively at url '''admin/modules''').
# Depending on what Wandora's submodules you have selected, each of them may require additional configuration. See Configuration section of each submodule you have enabled.
# For more information of installing Drupal modules go [http://drupal.org/node/70151 here].

=== Module - Wandora ===
Wandora module handles the centralizing of settings for each it's submodules. The module itself doesn't do much, but is mandatory if any of it's submodules is enabled.

=== Module - Instances Feed View ===
Instances Feed View is a Drupal module that read's an rss feed provided by Wandora and builds a small navigatable page out of it.

{| border="0" align="center"
|[[Image:Extras_drupal_module_rss_example.png|center]]
|}
==== Configuration ====
You can configure the module at '''Administer > Wandora > Instances Feed View - feed settings'''. Here you can change the path where feed is generated, for example '''<nowiki>http://127.0.0.1:8898/rss</nowiki>'''

==== Usage ====

To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_instances_feed</nowiki>'''. Something like in picture above should display. If not, then check the module is installed and correctly configured. Check also Wandora HTTP server is running.

=== Module - Topic Feed View ===

Topic Feed View is a module that read's an atom feed provided by Wandora and builds a navigable page out of it.

{| border="0" align="center"
|[[Image:Extras_drupal_module_atom_example.png|center]]
|}

==== Configuration ====
You can configure the module at '''Administer > Wandora > Topic Feed View - feed settings'''. Here you can change the path where feed is generated, for example '''<nowiki>http://127.0.0.1:8898/drupal_atom</nowiki>'''

==== Customization ====

To modify the background color of the generated tables:
:* Open '''wandora/wandora_topic_feed/wandora_topic_feed.css''' file
:* Modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.

==== Usage ====
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_topic_feed</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

=== Module - SOAP reader ===

SOAP reader is a module that read's a SOAP feed provided by Wandora and builds a navigable page out of it.

{| border="0" align="center"
|[[Image:Extras_drupal_module_atom_example.png|center]]
|}

==== Configuration ====

You can configure the module at '''Administer > Wandora > Wandora SOAP reader - feed settings'''. Here you can change two settings; the SOAP client path and default topic subject identifier.
# SOAP client path is axis server path from Wandora which by default is '''<nowiki>http://127.0.0.1:8898/axis</nowiki>'''
# Default topic subject identifier specifies default topic the module loads. Change the subject identifier here to the topic which you want to open by default.

==== Customization ====

To modify the background color of the generated tables:
:* Open '''wandora/wandora_soap/wandora_soap.css''' file
:* Modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.

==== Usage ====

To display any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_soap</nowiki>'''. Something like in picture above should display. If not, then check that the module is installed and correctly configured. Check also Wandora HTTP server is running.

Wandora Drupal extras

2011-06-16T10:51:38Z

User:Elias.tertsunen

2009-10-14T12:19:14Z

Elias.tertsunen:

2009-10-14T11:39:16Z

Elias.tertsunen:

Wandora Drupal extras

2009-10-14T11:24:47Z

Elias.tertsunen:

{| style="background:#EEEEFF;" cellpadding="10px"
|'''This article is a work in progress and therefore is not applicable to the current public version of Wandora.'''
In this article we'll go step-by-step, how set-up and use Wandora's Drupal extra modules.
|}

== Requirements ==
:* A working [http://drupal.org/project/drupal Drupal] 6 installation.
:* Newest [[Download|Wandora]] package.
:* Drupal extra modules(Included in Wandora software package in extras folder).

== Setting up Drupal ==
Since this does not belong to the scope of this article, i'll describe this in very few steps:
# Download newest [http://drupal.org/project/drupal Drupal] 6 installation package.
# Create mysql database and user with full privileges to the database.
# Extract Drupal to your desired web directory
# Navigate from your internet browser to the path where you have extracted drupal
# Follow the installation procedure and fill out the forms.
# Drupal should be now installed! If any problems occurred please refer to the [http://drupal.org/getting-started/install full installation manual].

For complete description of the installation procedure go [http://drupal.org/getting-started/install here], for testing purposes i would recommend to put up local server setup.

== Setting up Wandora ==
Installation and configuration of Wandora web server is described here.
=== Installing Wandora ===
# Please see Wandora [[System_requirements|system requirements]] first
# [[Download|Download]] the newest Wandora package
# [[How_to_install_Wandora|Install Wandora]]
# [[Running_Wandora|Launch up Wandora]]
=== Configuring Wandora web server ===
# [[Running_Wandora|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
#:[[Image:Extras_drupal_open_wandora_project.png]]
# Now select '''Server->Server settings...''' It should open a popup; here you can adjust Wandora's HTTP Server settings
#:[[Image:Extras_drupal_wandora_server_settings_marked.png]]
# Here there few things that are interest to us, mainly lines pointed by the red arrows(see the picture above). Port number indicated by first 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. Of course if you scroll down in the settings window, you'll see more services listed there, but only these three services we are going to need: '''axis, drupal_atom and rss'''.
# Let's test the Wandora server; make sure you have an [[Opening_a_topic|open]] topic(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.

== Module - Wandora Instances Feed View ==
Wandora Instances Feed View is a Drupal module that read's an rss feed provided by Wandora and builds a small navigatable page out of it.

[[Image:Extras_drupal_module_rss_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_rss_module/wandora_topic_feed''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora Instances Feed View in Drupal '''(Administer -> modules)'''.
# For more information of installing Drupal modules go [http://drupal.org/node/120641 here].
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora Instances Feed View - feed settings'''. Here you can change the path where feed is generated, for example: '''<nowiki>http://localhost:8898/rss</nowiki>'''
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_instances_feed</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

== Module - Wandora Topic Feed View ==
Wandora Topic Feed View is a module that read's an atom feed provided by Wandora and builds a navigatable page out of it.

[[Image:Extras_drupal_module_atom_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_atom_module/wandora_topic_feed''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora Instances Feed View in Drupal '''(Administer -> modules)'''.
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora Topic Feed View - feed settings'''. Here you can change the path where feed is generated, for example: '''<nowiki>http://localhost:8898/drupal_atom</nowiki>'''
=== Customization ===
; To modify the background color of the generated tables:
:* Open '''wandora_topic_feed/wandora_topic_feed.css''' file
:* modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_topic_feed</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

== Module - Wandora SOAP reader ==
Wandora Topic Feed View is a module that read's an atom feed provided by Wandora and builds a navigatable page out of it.

[[Image:Extras_drupal_module_atom_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_soap_module/wandora_soap''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora SOAP reader in Drupal '''(Administer -> modules)'''.
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora SOAP reader - feed settings'''. Here you can change two settings; the SOAP client path and default topic subject identifier.
# SOAP client path is axis server path from Wandora which by default is '''<nowiki>http://localhost:8898/axis</nowiki>'''
# Default topic subject identifier is default topic that the module load's in Drupal, change the subject identifier here to the topic which you want to be opened by default.
=== Customization ===
; To modify the background color of the generated tables:
:* Open '''wandora_soap/wandora_soap.css''' file
:* modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_soap</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

--[[User:Elias.tertsunen|Elias.tertsunen]] 17:26, 13 October 2009 (EEST)

Wandora Drupal extras

2009-10-14T11:17:16Z

Elias.tertsunen:

{| style="background:#EEEEFF;" cellpadding="10px"
|'''This article is a work in progress and therefore is not applicable to the current public version of Wandora.'''
In this article we'll go step-by-step, how set-up and use Wandora's Drupal extra modules.
|}

== Requirements ==
:* A working [http://drupal.org/project/drupal Drupal] 6 installation.
:* Newest [[Download|Wandora]] package.
:* Drupal extra modules(Included in Wandora software package in extras folder).

== Setting up Drupal ==
Since this does not belong to the scope of this article, i'll describe this in very few steps:
# Download newest [http://drupal.org/project/drupal Drupal] 6 installation package.
# Create mysql database and user with full privileges to the database.
# Extract Drupal to your desired web directory
# Navigate from your internet browser to the path where you have extracted drupal
# Follow the installation procedure and fill out the forms.
# Drupal should be now installed! If any problems occurred please refer to the [http://drupal.org/getting-started/install full installation manual].

For complete description of the installation procedure go [http://drupal.org/getting-started/install here], for testing purposes i would recommend to put up local server setup.

== Setting up Wandora ==
Installation and configuration of Wandora web server is described here.
=== Installing Wandora ===
# Please see Wandora [[System_requirements|system requirements]] first
# [[Download|Download]] the newest Wandora package
# [[How_to_install_Wandora|Install Wandora]]
# [[Running_Wandora|Launch up Wandora]]
=== Configuring Wandora web server ===
# [[Running_Wandora|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
#:[[Image:Extras_drupal_open_wandora_project.png]]
# Now select '''Server->Server settings...''' It should open a popup; here you can adjust Wandora's HTTP Server settings
#:[[Image:Extras_drupal_wandora_server_settings_marked.png]]
# Here there few things that are interest to us, mainly lines pointed by the red arrows(see the picture above). Port number indicated by first 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. Of course if you scroll down in the settings window, you'll see more services listed there, but only these three services we are going to need: '''axis, drupal_atom and rss'''.
# Let's test the Wandora server; make sure you have an [[Opening_a_topic|open]] topic(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 key'''. 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.

== Module - Wandora Instances Feed View ==
Wandora Instances Feed View is a Drupal module that read's an rss feed provided by Wandora and builds a small navigatable page out of it.

[[Image:Extras_drupal_module_rss_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_rss_module/wandora_topic_feed''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora Instances Feed View in Drupal '''(Administer -> modules)'''.
# For more information of installing Drupal modules go [http://drupal.org/node/120641 here].
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora Instances Feed View - feed settings'''. Here you can change the path where feed is generated, for example: '''<nowiki>http://localhost:8898/rss</nowiki>'''
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_instances_feed</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

== Module - Wandora Topic Feed View ==
Wandora Topic Feed View is a module that read's an atom feed provided by Wandora and builds a navigatable page out of it.

[[Image:Extras_drupal_module_atom_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_atom_module/wandora_topic_feed''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora Instances Feed View in Drupal '''(Administer -> modules)'''.
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora Topic Feed View - feed settings'''. Here you can change the path where feed is generated, for example: '''<nowiki>http://localhost:8898/drupal_atom</nowiki>'''
=== Customization ===
; To modify the background color of the generated tables:
:* Open '''wandora_topic_feed/wandora_topic_feed.css''' file
:* modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_topic_feed</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

== Module - Wandora SOAP reader ==
Wandora Topic Feed View is a module that read's an atom feed provided by Wandora and builds a navigatable page out of it.

[[Image:Extras_drupal_module_atom_example.png]]
=== Installation ===
# Copy/upload the '''wandora_installation_folder/extras/drupal_soap_module/wandora_soap''' folder to the '''sites/all/modules''' directory of your Drupal installation.
# Enable the Wandora SOAP reader in Drupal '''(Administer -> modules)'''.
=== Configuration ===
You can configure the module at: '''Administer -> Site configuration -> Wandora SOAP reader - feed settings'''. Here you can change two settings; the SOAP client path and default topic subject identifier.
# SOAP client path is axis server path from Wandora which by default is '''<nowiki>http://localhost:8898/axis</nowiki>'''
# Default topic subject identifier is default topic that the module load's in Drupal, change the subject identifier here to the topic which you want to be opened by default.
=== Customization ===
; To modify the background color of the generated tables:
:* Open '''wandora_soap/wandora_soap.css''' file
:* modify the '''background-color''' and/or '''border''' parameters in these classes: '''.subtitle''', '''.type''' and '''.cell'''.
=== Usage ===
To diplay any output navigate to '''<nowiki>http://your_full_drupal_path/wandora_soap</nowiki>'''. Something like in picture above should displayed. If not, then check that the module is installed and correctly configured and also check if Wandora HTTP server is running.

--[[User:Elias.tertsunen|Elias.tertsunen]] 17:26, 13 October 2009 (EEST)