IntegratingAigaion
From AigaionWiki
There are many people who want to integrate their Aigaion database more tightly with other systems such as CMS'es, password checking mechanisms, personal web pages, wikis, etc.
For integration of Aigaion into, e.g., TWiki, you would need several things. Most important are the following.
- A way to easily get data from the database for displaying Aigaion content in TWiki. This usually involves making a call to an Aigaion page and display the HTML returned from Aigaion in your TWiki page. See the embedding pages for more information.
- Combined login modules. Ideally, one would like to avoid users having to login twice (once to the TWiki, once to Aigaion). Our solution is to have "external login modules" for Aigaion. I.e., somehow you find a way to be able to determine whether a user is already logged in to TWiki, and, if so, the user with the same name will automatically be logged in for Aigaion as well. See the external login integration pages for more information.
The two parts are documented and discussed on their separate sections of this Wiki. Below you will find two examples of embedding to show what kinds of things are possible, and a list of all pages in the two subsections "embedding Aigaion data in other pages" and "integrating external login checking mechanisms into Aigaion".
Known integration efforts are listed at IntegratingAigaion/KnownIntegrationPlugins
Embedding examples
The first example uses a server side login to the Aigaion installation to embed some content into this wiki page using the #aigaionlink function. Using the command {{#aigaionlink: pub | ryynanen:06}}, we get a link to the given publication Transcription of the Singing Melody in Polyphonic Music. Note that the publication is only accessible to the 'demo' user account, so the wiki server needed to login to the database using the 'demo' account.
The second example uses the #aigaion function to retrieve the content using the current login session of the client browser. To see this, look at the embedded publication list of Anssi Klapuri, given below with the command {{#aigaion: author | 1054}}. Normally, you will see one publication, because you will right now not be logged in at the Aigaion demo database. However, if you now go to demo2.aigaion.nl, log in as demo/demo, then refresh this wiki page, you'll see that you get an additional second publication, which has become available to you because you are right now logged in in the Aigaion demo database.