/ta_reborn

is going online!

Primary LanguagePHP

Toulouse Acoustics WebSite

Que faut-il savoir pour reprendre le site? Je vais faire la liste des technologies utilisés, des bugs connus, des fonctionnalités présentes, de ce qui manque, etc...

Le site se découpe en trois parties:

  • Le front-end (le site visible par les utilisateurs)
  • Le back-end (l'admin du site, pour publier de nouvelles vidéos)
  • L'API, qui fait le lien entre le front-end et la base de donées.

###technologies à maitrisier pour reprendre le site sans trop de problèmes:

  • AngularJS
  • Bootstrap
  • PHP (POO et !POO)
  • Javascript
  • Mysql (PDO)

Technologies utilisés

1) Front-end

Le front-end se base sur du Javascript via le framework AngularJS en version 1.2. Il y a également du jQuery pour palier certaines difficutés renconrtés avec Angular. Côté dépendance Bootstrap est également massivement utilisé pour gérer le CSS.

Fichiers :

  • index.php : main file, contient le layout du site ainsi que les inclusions de script.
  • js/ :
    • app.js: config de base d'Angular.
    • controllers.js: logique complète du site
    • jque.js: jQuery en place sur le site
    • routes.js: routing Angular
    • services.js: services internes: appels à l'API, création des frames.
  • views/ : Toutes les vues du sites, chacune dans son fichier html.
  • css/ : Style du site dans style.css.
  • img/ :
    • badges/ : badges/icones du site.
    • headers/ : icones sociales utilisés
    • uniques. : Photos uploadés par la team. dans chaque sous dossier un dossier est créer portant l'id de l'artiste/quartier/... . un dossier min est également créer. Il contient les miniatures de chaque photo.
  • components/ : dépendances du site. (source d'Angular, Jquery, ...)

2) Back-end

Le back-end est en pur PHP avec un soupçon de Javascript. pas de framework ni de librairies.

Fichiers :

  • admin/ : ensemble des fichiers utilisé par le back-end. Plus de détails plus bas.
  • classes/ : classes PHP utilisés.
    • SimpleImage_class.php : Gère le cropping/resizing des images. C'est pas moi qui l'ai faite.
    • log_class.php : Gère la connection à l'admin (is logued?, is user?, set session, unset session)
    • tables_class.php : permet de créer des div simplement selon l'action utilisateur.
    • tapdo_class : Classe principale, fait le lien entre le php et la base de données, défini toutes les méthodes pour créer/modifier/supprimmer/récupérer vidéos/artistes/lieu/catégories. est appelé dans à peu près tout les fichiers côté admin, et dans l'API.
Le dossier admin.

L'admin se base sur de l'inclusion de fichiers php selon la page demandé. Chaque fichier contient généralement sa propre logique de fonctionnement, et se base sur les classes ainsi que sur un fichier clé de l'admin admin_functions.php.

admin_functions.php permet aussi bien de créer de l'html dynamiquement que de gérer la sauvegarde des photos, les fonctions y sont plutôt silmples mais malheureusement pas documentés.. désolé, je vais essayer de faire ça quand même...

3) API

L'API faisant le lien entre le front-end et la base de données elle est plutôt courte et simple. Elle se base uniquement sur des requètes GET (nope, c'est pas du REST) et ce n'est finalement qu'un gros switch case avec quelques helpers pour alléger le code.

Fichiers :

  • api.php : Point d'entrée de l'API, c'est là que doivent arriver les requètes.
  • contact.php : Vérifie en temps réel l'état d'envoi de message via l'onglet 'contact'. Envoie le mail quand c'est bon.

Base de donées

La base de données est sous MySQL, l'ensemble des tables nécéssaire étant présente dans le fichier ta.sql présent sur le repos. Y sont inclus par défaut des utilisateurs et un post. Il suffit d'envoyer ce fichier au serveur mysql pour préparer l'ensemble de la base de donées. La configuration Mysql se fait dans le fichier admin/conf/bdd_conf.json , la partie "init" contenant les champs à remplir.

Le fichier t_q.php à la racine du projet permet normalement de récupérer directement depuis viméo toutes les vidéos publiés, d'en extraire les infos importantes et de créer les posts relatif. En gros il est supposé tout faire tout seul. Mais après plusieurs modifications cela ne marche pas réelement comme prévu. Se serait donc à refaire. Viméo fourni maintenant une API pour récupérer directement toute une chaine : Lien API viméo.

Ce qui ne vas pas

####Côté Back-end Je viens de voir à l'instant un soucis d'éditeur de texte, l'admin utilise CKeditor pour pouvoir écrire/importer des textes mais il y a apparemment une erreur, un fichier non trouvé. J'y jetterais un coup d'oeuil. C'est tout pour l'admin, mais c'est plutôt sérieux comme problème..

####Côté Front-end Sur le front-end plusieurs problèmes:

  1. La page de contact se base sur ReCaptcha pour vérifier l'humanité de la personne voulant envoyer un message. ReCaptcha à évoluer depuis le temps, l'api à changée, du coup il vas falloir reprendre ça et regarder ce qui ne vas pas (ou enlever le captcha directement, mais on rique alors de voir pas mal de spam arrivé sur la boite de récéption...)

  2. Le design. Bon là j'aime pas trop ce que j'ai fait. Déjà c'est pas responsive, du coup sur mobile le site sort mal, c'est navigable mais c'est très loin des standards du web d'aujourd'hui.

J'y connais pas grand chose en responsive ni en design ni en css, c'est vraiment pas ma tasse de thé, du coup là y'a un travail de fond à faire je pense,avec quelqu'un qui s'y connait plus que moi en intégration...

Sinon ça marche plutôt bien. J'ai des erreurs javascript qui pètent dans la console mais elles sont liés à la version d'Angular utilisé, qui ne parse pas bien certaines chaînes, des images aparaissent comme 'Not found' sans qu'on est demandé à voir une image. en vrai ça marche bien.

A faire.

Sur l'admin il n'est pas possible pour le moment de programer une publication sur une date donnée. C'est donc à mettre en place, l'uttilisation d'une date > now() en bdd avec un contrôle sur la date du jour pour la récupération des vidéos devrait faire le taff merveilleusement.

Sur le Front-end il y à, je pense, tout le style à revoir. Chaque vue étant bien définie et le layout principal plutôt simple cela ne devrait pas être trop compliqué pour qui s'y connait un minimum.

Ensuite le Captcha comme mentionné plus haut.

Finalement les résaux sociaux ne sont pas inclus de la meilleure manières, on en a jamais trop parler donc je ne sais pas ce qu'il y a à faire mais c'est une question à se poser.

On est pas mal je pense, pour toute question : jules.buret@gmail.com

Bisettes!