Difference between revisions of "Exporting Data"

From ARK
Jump to: navigation, search
(Mod_Settings)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
In order to allow your users to use the export functionality of ARK you need to set a few settings in the mod_settings files. An example is [http://ark.lparchaeology.com/wiki/index.php/Mod_settings.php#Export here].
+
In order to allow your users to use the export functionality of ARK you need to set a few settings in the [[mod_settings.php]] and [[env_settings.php]] files. An example is [[Mod_settings.php#Export|here]].
  
You will also need to set up a couple of settings in settings.php, namely:
+
==Env_settings.php==
 +
===Export Directory===
 +
The export directories are set for each case in the top of the settings file, as seen (INSERT LINK TO SETTINGS). Listed below are example directories for each case
 +
*'''ms4w''':
 +
<pre>
 +
// EXPORT
 +
$export_dir = $ark_dir.'data/tmp/';
 +
</pre>
  
  // EXPORTS
+
*'''mac''':
  //export file location (where ARK exports will be saved - needs to be an absolute path)
+
<pre>
  $export_dir = "C:/ms4w/Apache/htdocs/$ark_dir/tmp"; absolute path on server to save the export file(s)
+
// EXPORT
  $web_export_dir = "$ark_dir/tmp/"; RELATIVE path where the export files(s) are saved.
+
$export_dir = $doc_root.$ark_dir.'data/downloads/';
 +
</pre>
  
 +
*'''linux''':
 +
<pre>
 +
// EXPORT
 +
$export_dir = $ark_dir.'data/tmp/';
 +
</pre>
 +
 +
==Page_settings - Tools==
 +
Each download and export tool used in the results toolbar in the search page (data_view) must also be set up in the [[page_settings.php]] file. These tools allow for exporting search results [[page_settings#Feeds|RSS and Atom feeds]] and exporting [[page_settings#Downloads|CSV]] files.
 +
 +
==Mod_settings - Subform==
 +
Each download mode needs to be set up as a subform within each of the mod_settings files allowing users to download data. The CSV downloader is the model for this. As the conf is a 'mac' or macro view (a.k.a data_view) subform, it should appear in the mod_settings as such. An example of the configured subform for CSV downloads can be seen in the [[Mod_settings.php#Export|mod_settings]] documentation.
  
If you want to add new export types - then you will need to write handlers for both the export itself (a function called exportCSV() and then a function that handles the elements named elemCSV()). It may be better to get a Developer to do this.
 
 
[[category: Administrator]]
 
[[category: Administrator]]

Latest revision as of 17:57, 24 February 2011

In order to allow your users to use the export functionality of ARK you need to set a few settings in the mod_settings.php and env_settings.php files. An example is here.

Env_settings.php

Export Directory

The export directories are set for each case in the top of the settings file, as seen (INSERT LINK TO SETTINGS). Listed below are example directories for each case

  • ms4w:
// EXPORT
$export_dir = $ark_dir.'data/tmp/';
  • mac:
// EXPORT
$export_dir = $doc_root.$ark_dir.'data/downloads/';
  • linux:
// EXPORT
$export_dir = $ark_dir.'data/tmp/';

Page_settings - Tools

Each download and export tool used in the results toolbar in the search page (data_view) must also be set up in the page_settings.php file. These tools allow for exporting search results RSS and Atom feeds and exporting CSV files.

Mod_settings - Subform

Each download mode needs to be set up as a subform within each of the mod_settings files allowing users to download data. The CSV downloader is the model for this. As the conf is a 'mac' or macro view (a.k.a data_view) subform, it should appear in the mod_settings as such. An example of the configured subform for CSV downloads can be seen in the mod_settings documentation.