Il y a 389 articles et 19 utilisateurs inscrits (ce bandeau est défini dans MediaWiki:Sitenotice)
« Doc/Module Pleade pour Drupal » : différence entre les versions
création+catégories |
m theme et explication |
||
| Ligne 33 : | Ligne 33 : | ||
Ce fihcier {{path|.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}}. | Ce fihcier {{path|.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.: {{path|wrap/}}) à la place du préfixe de l'application (e.g.: {{path|pleade/}}). | Par conséquent, dans {{drupal}}, les URLs faisant références à du contenu {{pleade}} doivent utilisées le prefixe (e.g.: {{path|wrap/}}) à la place du préfixe de l'application (e.g.: {{path|pleade/}}). | ||
[[File:Module-prefix-menu.png]] | [[File:Module-prefix-menu.png||center]] | ||
Dans l'exemple ci-dessus, l'url {{path|'''wrap/'''mets-search-form.html}} sera ré-récrite '''par {{drupal}}''' en [http://app.dev/pleade/mets-search-form.html http://app.dev/'''pleade/'''mets-search-form.html] | |||
Dans l'exemple ci-dessus, l'url {{path|'''wrap/'''mets-search-form.html}} sera ré-récrite '''par {{drupal}}''' en [http://app.dev/pleade/mets-search-form.html 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 == | == Arborescence des fichiers == | ||
| Ligne 81 : | Ligne 82 : | ||
| {{var|PLEADE_CONTEXT}} | | {{var|PLEADE_CONTEXT}} | ||
|| {{value|{{path|pleade/}}}} | || {{value|{{path|pleade/}}}} | ||
|| Pleade application/sub-directory | || {{Pleade}} application/sub-directory | ||
|- | |- | ||
| {{var|PLEADE_URL}} | | {{var|PLEADE_URL}} | ||
|| {{value|http://bm-orleans.dev/'.PLEADE_CONTEXT}} | || {{value|http://bm-orleans.dev/'.PLEADE_CONTEXT}} | ||
|| {{important|need trailing slash !}} | || {{important|need trailing slash !}} | ||
Public URL for the Pleade application | Public URL for the {{Pleade}} application | ||
|- | |- | ||
| {{var|DRUPAL_CONTEXT}} | | {{var|DRUPAL_CONTEXT}} | ||
|| {{value|wrap}} | || {{value|wrap}} | ||
|| Prefix to indicate the URL should be resolved against Pleade app | || Prefix to indicate the URL should be resolved against {{Pleade}} app | ||
|- | |- | ||
| {{var|PLEADE_MIMETYPE_TO_WRAP}} | | {{var|PLEADE_MIMETYPE_TO_WRAP}} | ||
| Ligne 103 : | Ligne 104 : | ||
</syntaxhighlight> | </syntaxhighlight> | ||
}} | }} | ||
|| URL send to Pleade application | || URL send to {{Pleade}} application by {{drupal}} via {{cmd|[[http://api.drupal.org/api/drupal/includes!common.inc/function/drupal_http_request/7 drupal_http_request()]]}} | ||
|} | |} | ||
=== Theme de la page d'accueil === | === Theme de la page d'accueil === | ||
Version du 26 mars 2013 à 16:58
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 :
- votre configuration d'hôte virtuel ;
- 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
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.