DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Typogorum - Open Source Document Management (DMS)

Created:2010-02-18T17:33:18
Changed:2010-07-16T11:41:32.950000000
Classification:typogorum
Description:The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----
Keywords:agorum core, document management system, dms, typogorum, dokumentenmanagement, dokumentenverwaltung, forAdmins, forIntermediates, ecm, enterprise content management, workflow, archiv
Author:Yves Hoeppe
Email:info2@agorum.com
Info 4:http://www.agorum.com
Language:en, de

img-1 img-2 Typogorum - Open Source Document Management (DMS) - typogorum

Typogorum - Open Source Document Management (DMS)

Extension Key: typogorum

Language: en, de

Keywords: agorum core, document management system, dms, typogorum, dokumentenmanagement, dokumentenverwaltung, forAdmins, forIntermediates, ecm, enterprise content management, workflow, archiv

Copyright 2000-2010, Yves Hoeppe, <info2@agorum.com>

Website: http://www.agorum.com

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

Typogorum 1

`Introduction 3 <#__RefHeading__960_1887072950>`_

What does it do? 3

Screenshots 3

`Users manual 4 <#__RefHeading__966_1887072950>`_

How to use it... 4

`Administration 5 <#__RefHeading__970_1887072950>`_

How to administrate the extension... 5

`Configuration 7 <#__RefHeading__974_1887072950>`_

Reference 7

Introduction

What does it do?

Typogorum provides a very convenient way of displaying the structure of your agorum core installation. You can go through the folders, open and save documents. Text documents can be transformed into pdf - files. It also includes a full text search engine, which allows you to use place holders or to do similarity search.

Screenshots

img-3

Users manual

How to use it...

Zapping through the folders should be self-explaining. The breadcrumbs can always lead you back to where you came from when going steps deeper into the folders.

Using the search engine is – depending on how detailed you want to search – a little more complex. Here some facts about how to use the search engine:

  • It is not case sensitive. So it doesn't make a difference whether you search for 'Demo' or for 'demo'.
  • The “AND” (capital letters) operator is optional. Example: 'who are you' would give the same results as 'who AND are AND you'.
  • You can use the word “OR” (capital letters) to search for several words, which not necessarily have dependencies to each other. Using the word “OR” always goes with brackets around the expression. Example: '(steve OR philipp)'
  • You are allowed to put parts of the expression into another pair of brackets. Example: '((steve miller) OR (philipp coleman))' In this case you would search for results containing “steve” and “miller” or “philipp” and “coleman”.
  • There is an operator called “NOT” (capital letters). You can use “NOT” to exclude certain search words. Example: '((steve miller) AND NOT (philipp coleman))'
  • Speacial characters such as “+”, “-”, “&”, “|”, “!”, “(”, “)”, “{”, “}”, “[”, “]”, “^”, “~”, “*”, “?”, “:”, “”, “ '' ” have to be masked by using “” with each special character. Example: 'what are you looking for?'
  • You can do similarity search by using “~” at the end of the word. Example: 'theater~' to get both “theater” (American English) and “theatre” (British English)
  • Search for words in a special order can be done by using the character “ around the expression. Example 1: ' “in this order” ' The results here would contain the expression exactly in the way it's written. Example 2: ' “test phase”~5 ' The results here would contain the words in the order of the expression and the words can have a maximum of 5 other words in between.
  • You can exclude words within the documents you want to find. Example: 'task -done' This expression would give you all tasks, which are not done yet.
  • The relevance of a search word can be important. Example: 'free^2 software' “free” has a higher priority than software now. The factor has to be greater than 0 at least.

Downloading and opening documents is quite easy. Just click on the document itself. Downloading and opening a textdocument as a pdf file is not more complicated. Click on the “[PDF]” - sign next to the document you want to open.

Administration

How to administrate the extension...

Step 1 (import and install):

Install the typogorum extension. Go to “Ext Manager” and chose “Import extensions”.

  1. Search for “typogorum”. Import and install the extension.

b) Upload the extension from your hard drive and install the extension.

img-4
Step 2 (configure typoscript):

Go to your typoscript template (root template or ext template of the page you want to put typogorum inside) and choose “Setup”. Configuring “server” and “folderId” is the minimum typoscript configuration. See “Configuration” / “Reference” on page six for further explanations. Pay special attention to static users and frontend login.

img-5

img-6

If you want to define your typoscript in “Constants” instead of “Setup”, go to your typoscript template and choose “edit whole template record”, then choose “Includes” and add “static_typogorum(typogorum)”. You will also have to do this, if you want to use the default value for “folderId”.

img-7

The extension supports English and German language.

By setting the typoscript parameters “config.language” to “de” or “en” and “config.locale_all” to “de_DE”, “en_EN” or “en_US”, you can set your desired language and the extension will automatically use these configurations.

Example:

config.language = de
config.locale_all = de_DE

Note: “_LOCAL_LANG”, “language” and “locale_all” can only be configured in “Setup”.

Step 3 (use typogorum plugin):

Go to “Page” and choose the page you want to have your typogorum plugin inside. Create a new record called “General Plugin”. Go to “Plugin” and choose “typogorum”. Save it.

img-8

Now you should know, whether you want to use a static user or frontend login. If you want to use frontend login, you will have to do the following things. Otherwise go to step 4.

Install any frontend login extension (if you don't have already), e.g. “felogin”. Go to “Ext Manager” and choose “Import extensions”.

  1. Search for “felogin”. Import and install the extension.

b) or Upload the extension from your hard drive and install the extension.

Choose the page you want to have your frontend login plugin inside. Create a new record called “Login form”. In the register-page “Insert plugin” choose the Sysfolder (under Startingpoint) where you have stored your users.

img-9
Step 4 (handle users):

a) Declare a static user in your typoscript template for your plugin. See “Configuration” / “Reference” on page six for further explanations.

Create a new sysfolder for frontend users (if you don't have already). Go to “Page” and choose the point you want to put your sysfolder inside. Right-click on your desired page and choose “New”, then choose “Page inside” or “Page after”, depending on where you want to put the sysfolder. Choose the type “sysfolder”. Type in a page title. Go to “Options” and choose “Website users” in “Contains plugin”. Save it.

img-10

img-11

  • Go to “List” and choose your frontend user sysfolder. Create a new record called “Website usergroup”. Type in your desired grouptitle. Save it.

    img-12

  • Go to “List” and choose your frontend user sysfolder. Create as many records called “Website user” as you want to. Give them the usergroup you created before. Make sure that the users you created, exist in your agorum core installation and that their password fits their username.

    img-13

  • Now the most important step: Go to “Page”,choose the page you put your typogorum plugin inside. Edit the plugin and go to “Access”. Choose the usergroup of your typogorum users.

img-14
Step 5(enjoy typogorum):

Your plugin of typogorum should work properly now. If not, feel free to contact us.

We hope, you'll enjoy it.

Note:

You can install typogorum several times on the same or different pages. When installed on different pages, different typoscript configuration is possible. Note that there can only be one session for each frontend user / browser.

When testing, always keep your browser and typo3 cache empty. You can set the following typoscript parameter to make typo3 cache nothing at all. This parameter can only be set in “Setup”.

Example:

config.no_cache = 1

Configuration

Reference

server

Property

server

Data type

string

Description

This is the server-ip of your agorum core server.

Example:

plugin.tx_typogorum_pi1{
  http://192.278.161.19:8080
}

Default

empty

folderId

Property

folderId

Data type

string

Description

This is the most outer folder of the folder hierarchy, which you want to make public to the user(s). Login to your agorum desk4web. Left- click on the parent folder of the folder you want to make public. In the right-hand area of agorum desk4web, right-click on the folder you want to make public and left-click on the information symbol. The Object-ID equates to the folderId.

Example:

plugin.tx_typogorum_pi1{
  folderId = 1004446
}

Default

1004446

user

Property

user

Data type

string

Description

(optional)

This is the agorum core user you can set, if you want to have a static user for the plugin. Otherwise you have to use frontend login.

Example:

plugin.tx_typogorum_pi1{
  user = roi
}

Default

empty

password

Property

password

Data type

string

Description

(optional)

This is the password according to the agorum core user you chose.

Example:

plugin.tx_typogorum_pi1{
  password = t3agorum
}

Default

empty

loginFaultId

Property

loginFaultId

Data type

string

Description

(optional)

This is the id of the typo3 page you want to redirect to, if login fails. Get the id of your desired page by hovering over the symbol next to the name of the page in typo3 modul “Page”.

Example:

plugin.tx_typogorum_pi1{
  _loginFaultId = 256
}

Default

empty

_LOCAL_LANG

Property

_LOCAL_LANG

Data type

array of strings

Description

(optional)

Here you can overwrite the labels of the extension.

Example:

plugin.tx_typogorum_pi1{
  _LOCAL_LANG.en{
    headerText = agorum Document Management
    searchText = Your search word
    resultCountText1 =
    resultCountText2 = results found
    startName = Root Folder
  }
}

Default

empty

img-2 13