Difference between revisions of "Administrator Manual"

From ARK
Jump to: navigation, search
(Installation and Setup)
 
(22 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
__TOC__
 
__TOC__
  
The administrator manual is aimed at people who are downloading and installing ARK. If you are struggling with installation or administration, you should consider contacting the ARK team to buy a preconfigured ARK. This would help support the project and make a contribution towards the ongoing development of the project.
+
The administrator manual is aimed at people who are downloading and installing ARK. If you are struggling with installation or administration, you should consider contacting the ARK team via the [http://groups.google.com/group/arkusers Google Group].
  
 
===Key Concepts===
 
===Key Concepts===
Line 8: Line 8:
  
 
Information about the navigation tools used within ARK.
 
Information about the navigation tools used within ARK.
 
=====[[Navigation#Basic Navigation|Basic Navigation]]=====
 
 
=====[[Navigation#Subform Navigation|Subform Navigation]]=====
 
  
 
====[[Views]]====
 
====[[Views]]====
Line 20: Line 16:
  
 
An overview of the key administration concepts.
 
An overview of the key administration concepts.
 
=====[[Key Administration Concepts#Settings Files|Settings Files]]=====
 
 
=====[[Key Administration Concepts#Forms Overview|Forms Overview]]=====
 
  
 
===Installation and Setup===
 
===Installation and Setup===
Line 30: Line 22:
  
 
A description of the ARK installation process.
 
A description of the ARK installation process.
 
=====[[Basic Installation#Dependencies|Dependencies]]=====
 
 
=====[[Basic Installation#Installing ARK|Installing ARK]]=====
 
 
=====[[Basic Installation#Browse to ARK directory|Browse to ARK]]=====
 
 
====[[Initial setup]]====
 
 
Some things to consider when completing the initial setup of your ARK.
 
 
=====[[Initial setup#A Name|ARK Name]]=====
 
 
=====[[Initial setup#What do you want to record?|What to record?]]=====
 
 
=====[[Initial setup#What subforms do you want?|What Subforms?]]=====
 
  
 
====[[Database Tables]]====
 
====[[Database Tables]]====
Line 58: Line 34:
  
 
A description of the env_settings.php file for three different operating systems.
 
A description of the env_settings.php file for three different operating systems.
 
=====[[env_settings.php#ms4w|Mapserver for Windows]]=====
 
 
=====[[env_settings.php#mac|Mac]]=====
 
 
=====[[env_settings.php#linux|Linux]]=====
 
  
 
====[[field_settings.php]]====
 
====[[field_settings.php]]====
  
 
Instructions on how to configure the field_settings.php file.
 
Instructions on how to configure the field_settings.php file.
 
=====[[field_settings.php#Common/Obligatory Attributes|Obligatory Attributes]]=====
 
 
=====[[field_settings.php#Class Specific Settings|Class Specific Settings]]=====
 
 
=====[[field_settings.php#Event Fields|Event Fields]]=====
 
  
 
====[[mod_settings.php]]====
 
====[[mod_settings.php]]====
  
 
Instructions on how to configure module specific settings files.
 
Instructions on how to configure module specific settings files.
 
=====[[mod_settings.php#Display Options|Display Options]]=====
 
 
=====[[mod_settings.php#Custom Fields|Custom Fields]]=====
 
 
=====[[mod_settings.php#Subforms|Subforms]]=====
 
 
=====[[mod_settings.php#Spatial Data|Spatial Data]]=====
 
 
=====[[mod_settings.php#Data Entry Forms|Data Entry Forms]]=====
 
 
=====[[mod_settings.php#Micro View|Micro View]]=====
 
 
=====[[mod_settings.php#Data View|Data View]]=====
 
 
=====[[mod_settings.php#XMI View|XMI View]]=====
 
 
=====[[mod_settings.php#Export|Export]]=====
 
  
 
====[[settings.php]]====
 
====[[settings.php]]====
Line 101: Line 47:
 
The general settings for ARK.
 
The general settings for ARK.
  
=====[[settings.php#Server Setup|Server Setup]]=====
+
====[[page_settings.php]]====
  
=====[[settings.php#General|General]]=====
+
The settings for page based displays and navigation.  
 
 
=====[[settings.php#Live Search|Live Search]]=====
 
 
 
=====[[settings.php#Modules|Modules]]=====
 
 
 
=====[[settings.php#Security|Security]]=====
 
 
 
=====[[settings.php#Skin|Skin]]=====
 
 
 
=====[[settings.php#Thumbnails|Thumbnails]]=====
 
 
 
=====[[settings.php#Forms|Forms]]=====
 
 
 
=====[[settings.php#Viewers|Viewers]]=====
 
 
 
=====[[settings.php#Mapping|Mapping]]=====
 
 
 
=====[[settings.php#Logging|Logging]]=====
 
 
 
=====[[settings.php#Search Engine|Search Engine]]=====
 
 
 
=====[[settings.php#Languages|Languages]]=====
 
 
 
=====[[settings.php#Fields|Fields]]=====
 
 
 
=====[[settings.php#Document Type|Document Type]]=====
 
 
 
=====[[settings.php#Navigation|Navigation]]=====
 
 
 
=====[[settings.php#Left Panel Configuration|Left Panel Configuration]]=====
 
  
 
====[[vd_settings.php]]====
 
====[[vd_settings.php]]====
Line 152: Line 68:
  
 
Some optional subform fields generic to all modules and subform types.
 
Some optional subform fields generic to all modules and subform types.
 +
 +
====[[Conditional Subforms]]====
 +
 +
Conditional subforms is a more complex subform option that allows specific subforms to only be displayed if a set of pre-configured conditions are met
  
 
====[[Subform Reference]]====
 
====[[Subform Reference]]====
Line 157: Line 77:
 
A list of all the current subforms with example configurations.
 
A list of all the current subforms with example configurations.
  
=====[[Subform Reference#Text Subforms|Text Subforms]]=====
+
===Mapping===
 
 
=====[[Subform Reference#Number Subforms|Number Subforms]]=====
 
 
 
=====[[Subform Reference#Attribute Subforms|Attribute Subforms]]=====
 
 
 
=====[[Subform Reference#Spatial Subforms|Spatial Subforms]]=====
 
 
 
=====[[Subform Reference#Span Subforms|Span Subforms]]=====
 
  
=====[[Subform Reference#File Subforms|File Subforms]]=====
+
====[[Mapping Overview]]====
 +
Some general information about mapping in ARK.
  
=====[[Subform Reference#XMI Subforms|XMI Subforms]]=====
+
====[[Configuring the Mapfile]]====
 +
Instructions on how to configure the mapfile.
  
=====[[Subform Reference#Complex Subforms|Complex Subforms]]=====
+
====[[OpenStreetMap and ARK]]====
 +
Instructions on how to use OpenStreetmap as your mapping BaseLayer
  
===Mapping===
+
====[[Google Maps and ARK]]====
 +
Instructions on how to use Google Maps as your mapping BaseLayer
  
 
===Administration===
 
===Administration===
Line 200: Line 116:
  
 
Information about the ongoing development of import tools.
 
Information about the ongoing development of import tools.
 +
 +
====[[The ARK Help System]]====
 +
 +
How to use and administer the Help system.
 +
 +
====[[Setting up the Wordpress Plugin]]====
 +
 +
This is how to setup and use the ARK Wordpress plugin
 +
 +
===Configuring Clean URLs===
 +
 +
ARK can be configured to use clean URLs, that is instead of visiting a page using a URL like: http://www.myark.com/ark/micro_view.php?item_key=cxt_cd&itemvalue=ABC12_1234 you can visit: http://www.myark.com/ark/view/cxt/ABC12_1234. This allows for persistent clean URLs and also aids in Search Engine Optimisation, etc. If you are still not sure you want to do this, [http://www.hochmanconsultants.com/articles/clean-urls.shtml here] is an article explaining it a bit further.
 +
 +
If you still want to do it there are a number of steps to go through:
 +
 +
1. [[Set up your webserver to enable mod_rewrite]]
 +
 +
2. [[Set up your Rewrite Rules]]
 +
 +
3. [[Check the setup and adjust your main pages]]
  
 
===Custom Configuration===
 
===Custom Configuration===
Line 210: Line 146:
  
 
====[[Configuring the Mapping]]====
 
====[[Configuring the Mapping]]====
 +
 +
====[[Configuring RSS Feeds]]====
  
 
[[category: Administrator]]
 
[[category: Administrator]]

Latest revision as of 08:45, 16 November 2015

The administrator manual is aimed at people who are downloading and installing ARK. If you are struggling with installation or administration, you should consider contacting the ARK team via the Google Group.

Key Concepts

Navigation

Information about the navigation tools used within ARK.

Views

The different 'Views' of ARK.

Key Administration Concepts

An overview of the key administration concepts.

Installation and Setup

Basic Installation

A description of the ARK installation process.

Database Tables

A list of the standard ARK tables, with a basic explanation for each.

ARK Customisation

This chapter will help the new ARK administrator who is comfortable with editing PHP configuration files through the setup of an ARK project. For a general overview of settings please see Settings Files.

env_settings.php

A description of the env_settings.php file for three different operating systems.

field_settings.php

Instructions on how to configure the field_settings.php file.

mod_settings.php

Instructions on how to configure module specific settings files.

settings.php

The general settings for ARK.

page_settings.php

The settings for page based displays and navigation.

vd_settings.php

A description of information found within the vd_settings.php file.

Subforms

Subforms Overview

A general overview of ARK Subforms and their configuration.

Subform Requirements

The required fields for configuration of subforms.

Subform Options

Some optional subform fields generic to all modules and subform types.

Conditional Subforms

Conditional subforms is a more complex subform option that allows specific subforms to only be displayed if a set of pre-configured conditions are met

Subform Reference

A list of all the current subforms with example configurations.

Mapping

Mapping Overview

Some general information about mapping in ARK.

Configuring the Mapfile

Instructions on how to configure the mapfile.

OpenStreetMap and ARK

Instructions on how to use OpenStreetmap as your mapping BaseLayer

Google Maps and ARK

Instructions on how to use Google Maps as your mapping BaseLayer

Administration

User Administration

Some tools for administering user accounts.

Address Book Administration

How to update the Address Book module.

Alias Administration

How to add aliases to the database.

Markup Administration

How to add markup to the database.

Exporting Data

Some basic tips for exporting data.

Importing Data

Information about the ongoing development of import tools.

The ARK Help System

How to use and administer the Help system.

Setting up the Wordpress Plugin

This is how to setup and use the ARK Wordpress plugin

Configuring Clean URLs

ARK can be configured to use clean URLs, that is instead of visiting a page using a URL like: http://www.myark.com/ark/micro_view.php?item_key=cxt_cd&itemvalue=ABC12_1234 you can visit: http://www.myark.com/ark/view/cxt/ABC12_1234. This allows for persistent clean URLs and also aids in Search Engine Optimisation, etc. If you are still not sure you want to do this, here is an article explaining it a bit further.

If you still want to do it there are a number of steps to go through:

1. Set up your webserver to enable mod_rewrite

2. Set up your Rewrite Rules

3. Check the setup and adjust your main pages

Custom Configuration

The following are examples of custom configurations and may be specific to previous installations of ARK. Only use these for reference if you are upgrading from development code prior to the v0.6 release. Please contact the ARK Development Team for more information on any of the following.

Transcluding

Configuring file registration

Configuring the Mapping

Configuring RSS Feeds