Doc/Module Pleade pour Drupal

Drupal

Important :

Documentation obsolète ! à mettre à jour.

 :

Droits et propriétaire

Important :

Penser à vérifier les droits de vos fichiers. Ils doivent être accessible au groupe d'Modèle:Apache :

1. ajouter votre utilisateur au groupe (www-data sur Ubuntu) :

sudo usermod -a -G www-data $(whoami) # se rajoute au groupe apache
# penser à vous dé/reconnecter

1. changer les droits du répertoire de Drupal :

sudo chmod u=rwx,g=rwx,o= -R "$repertoireDrupal" # change les droits (récursivement)

1. Devenir responsable du répertoire de Drupal :

sudo chown $(whoami):www-data -R "$repertoireDrupal" # change le groupe (récursivement)

.

Installation de Modules

L'installation manuelle se fait en plaçant les *.tar.gz dans <repertoire-drupal>/sites/all/modules/.

To do :

Vérifier les droits des fichiers télécharger/dé-compressés comme décrit dans la section #Droits et propriétaire.

Configuration Apache

Virtual Host

Pleade étant embarquée dans Drupal, on modifiera le virtual host pour que Drupal soit à la racine de l'hote et que Pleade soit un sous-répertoire de cet hôte :

• http://bm-orleans.dev/ -> drupal ;
• http://bm-orleans.dev/pleade/ -> pleade.

La configuration minimale pour votre hôte virtuel est la suivante :

<VirtualHost *:80>
  ServerName bm-orleans.dev

  DocumentRoot /chemin/vers/drupal

  # Pleade
  ProxyPass /pleade ajp://localhost:8009/bm-orleans
  ProxypassReverse /pleade ajp://localhost:8009/bm-orleans

  # Drupal
  <Directory /chemin/vers/drupal/>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Order allow,deny
    allow from all
  </Directory>

  # configuration pour IIPimage, Logs, etc.
</VirtualHost>

Fichier .htaccess dans Drupal

Le module Pleade travail avec le fichier .htaccess, placé à la racine de votre installation Drupal.

Ce fihcier .htaccess permet de ré-écrire les URLs envoyés par le module Drupal vers l'application Pleade. Ce mécanisme permet de rester dans le context Drupal. Par conséquent, dans Drupal, les URLs faisant références à du contenu Pleade doivent utilisées le prefixe (e.g.: wrap/) à la place du préfixe de l'application (e.g.: pleade/).

Dans l'exemple ci-dessus, l'url wrap/mets-search-form.html sera ré-récrite par Drupal en http://app.dev/pleade/mets-search-form.html. Drupal fera ce travail en interne, lancera la requête, récupèrera son contenu et l'insèrera dans son corps de page.

Arborescence des fichiers

├── sites
│   ├── all
│   ├── modules
│   │   ├── pleade
│   │   │   ├── pleade.info
│   │   │   └── pleade.module
│   ├── themes
│   │   ├── bartik
│   │   │   ├── banner.jpg
│   │   │   ├── bartik.info
│   │   │   ├── color
│   │   │   │   └── color.inc
│   │   │   ├── css
│   │   │   ├── images
│   │   │   └── templates
│   │   │       └── page--front.tpl.php
│   │   ├── pleade -> bartik
│   │   └── README.txt
├── .htaccess

Module Pleade

Les fichiers liés au module sont dans le répertoire : Drupal/sites/all/modules/pleade/

Informations et déclaration du module: pleade.info

Le fichier est nécessaire, il permet de déclarer :

• le module ;
• sa description ;
• la version de Drupal que l'on gère.

Module: pleade.module

Ce module doit être en accord avec :

1. votre configuration d'hôte virtuel ;
2. et votre fichier #Fichier .htaccess dans Drupal.

En effet, les variables que vous définissez dans ce fichier on des correspondances dans ces fichiers.

Il vous faudra notamment définir les constantes dans le fichier pleade.module et et vérifier leur correspondances dans le .htaccess et l'hôte virtuel :

Constante	Défaut	Description
PLEADE_CONTEXT	pleade/	Pleade application/sub-directory
PLEADE_URL	http://bm-orleans.dev/'.PLEADE_CONTEXT	Important : need trailing slash !. Public URL for the Pleade application
DRUPAL_CONTEXT	wrap	Prefix to indicate the URL should be resolved against Pleade app
PLEADE_MIMETYPE_TO_WRAP	/.*\.(htm|html)(\?(.*))*/	Content type we will wrap in Drupal context
$GLOBALS['REWRITE_CONTEXT']	array( '"ead.html?' => sprintf('"%sead.html?', PLEADE_CONTEXT) );	URL send to Pleade application by Drupal via [drupal_http_request()]

Theme de la page d'accueil

Notice :

Ayez conscience que Drupal cache les pages et les contenants, désactivé le durant vos tests.

On reprends l'approche décrite dans Customize the front page template, et il suffit de définir un fichier de template « local » : sites/all/themes/pleade/templates/page--front.tpl.php et l'adapter.

Recherche Fédérée

Le bloc gérant la recherche fédérée nécessite l'activation du module PHP filter.

Tomcat

Configuration du serveur : server.xml

To do :

Si vous rencontrez des problèmes avec l'authentification, veuillez vérifier Vérifier que la configuration de Apache Tomcat et la suivante.

    <Connector port="8080" protocol="HTTP/1.1"
		connectionTimeout="20000"
		redirectPort="8443"
		emptySessionPath="true"
	/>

    <Connector port="8009" protocol="AJP/1.3"
		redirectPort="8443"
		emptySessionPath="true"
	/>