Projet spécifique mobile : Service préexistant : crousmenus, DiningPortlet Dates de livraison : Intervenants : Université de La Rochelle |
RésuméType d'application : Application Web Type d'adaptation pour l'application Web : - portlet Responsive basée sur Twitter Bootstrap
Fonctionnalités : - Afficher le listing des restaurants des différentes zones géographiques indiquées dans le flux XML émanant des CROUS.
- Pour chaque RU, afficher son description (coordonnées, dates/heures d'ouverture,...) ainsi que la liste des plats servis dans ce restaurant
- Interface d'administration
- L'utilisateur peut personnaliser ce service :
- marquer des restaurants en tant que favoris
- indiquer ses préférences nutritionnelles et les aliments auxquels il est allergique
- Géolocalisation (indiquer les RUs les plus proches)
Reconnaissance du terminal : - Se base sur la taille de la zone d'affichage et non la nature du terminal
Terminaux mobiles ciblés : - Tous les terminaux : du desktop aux mobiles (service responsive)
|
|
Éléments requis
- un ENT EsupPortail / uPortal V4 ou supérieur
- un SGBD (MySQL ou PostgreSQL)
- L'accès au flux du CROUS (prendre contact avec le CROUS de votre région pour récuperer les URL)
Téléchargement / code source
https://github.com/EsupPortail/esup-dining
Configuration
Les configurations se font dans les fichier defaults.properties et config.properties se trouvant dans le dossier src/main/resources
- auth.bean
- ID du bean pour authentifier l'utilisateur au sein de la portlet, voir les différents bean disponible dans le fichier esup-dining-domain-services-auth.xml
- user.admin.role
- Rôle de l'utilisateur dans uPortal. Tous les utilisateurs possédant ce rôle pourront accéder à l'interface d'administration de la portlet dans le mode EDIT
- feeds.list.url
- Lien vers le fichier JSON contenant l'ensemble des flux distribué par le CROUS
- ATTENTION : Aujourd'hui ce fichier n'est pas diffusé sur les serveurs du CROUS rendant la portlet inutilisable. La documentation sera mise à jour dès que ce document sera en production
- cas.url
- auth.portal.uidAttribute
- Attribut contenant le UID de l'utilisateur
- date.locale.pattern
- Format dans lequel les dates doivent être formaté
- db.driver
- db.infos
- Lien vers la base de données (ex : jdbc:postgresql://localhost/restaurant )
- db.username
- Nom d'utilisateur pour la connexion à la base de données
- db.password
- Mot de passe pour la connexion à la base de données
Déploiement de la base de données
Le déploiement de la base de données s'effectue via une tâche Maven.
mvn exec:java -Dexec.args="database [ACTION A RÉALISER]" |
Le second argument peut prendre les valeurs suivantes :
Chacune de ces actions fait référence à un fichier .sql se trouvant dans le dossier src/main/resources/database/
Configuration après le déploiement de la portlet
Une fois la portlet déployée et intégrée dans le portail il est nécessaire de définir le flux à afficher et les zones disponibles par défaut. Pour cela, il faut se rendre dans le mode EDIT de la portlet.
Si les configurations auth.bean et user.admin.role ont été correctement effectué un lien "PARAMETRES ADMINISTRATEUR" devrait apparaître.
Il faut dans un premier temps choisir le flux désiré dans la liste déroulante puis cocher les zones à afficher par défaut aux utilisateurs.
Les données affichées ci-dessus sont factices.
Copies d'écran
Contacts
Merci de vous abonner et d'utiliser la liste mail "esup-utilisateurs" pour nous contacter (problèmes techniques notamment) :
https://listes.esup-portail.org/sympa/info/esup-utilisateurs
Crédits & Licence
Copyright (C) 2014 Esup Portail http://www.esup-portail.org
@Author (C) 2014 Germain Souquet <germain.souquet@univ-lr.fr>
@Contributor (C) 2014 Germain Souquet <germain.souquet@univ-lr.fr>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.