• Installation
• Mise à jour
• Configuration 
• Menus
• Modules
• Personnalisation

Installation

Dans l'interface d'administration de votre site Joomla!, rendez-vous dans le menu "Extensions" puis cliquez sur le lien "Gestion des extensions".

Vous arrivez alors automatiquement dans l'onglet "Installation", dans lequel le premier bloc se nomme "Archive à envoyer". Cliquez alors sur le bouton "Parcourir" pour rechercher l'archive du composant (que vous avez reçue par mail) sur votre ordinateur. Celle-ci se nomme com_neorecruit_X_Y_Z.zip, les caractères X, Y et Z correspondant aux numéros de la version du composant. Cliquez ensuite sur le bouton "Envoyer & Installer" pour lancer le processus d'installation.

L'installation peut prendre quelques secondes, veuillez simplement attendre le chargement complet de la page pour être certain que l'opération est bien terminée. Vous verrez alors un message de confirmation apparaître, ainsi qu'une d'une brève description du composant.

Mise à jour

Si vous utilisez déjà une précédente version du composant NeoRecruit et que souhaitez le faire évoluer vers une version plus récente, il vous suffit de transférer l'archive de la nouvelle version du composant dans le gestionnaire des extensions de Joomla, de la même manière que si vous installiez une nouvelle extension.

Configuration

Pour modifier la configuration de votre composant, rendez vous dans le menu "Composants" de votre interface d'administration, puis cliquez sur NeoRecruit. Vous accédez alors au panneau d'administration de NeoRecruit. Dans ce panneau, cliquez sur l'icône "Configuration". Vous pouvez alors éditer les paramètres généraux du composant ainsi que les valeurs par défaut utilisée lors de la création d'une nouvelle offre.

Paramètres généraux

• Le texte d'introduction : texte de présentation générale des offres, qui n'apparaît que sur la première page du composant.
  
• Les auteurs : déterminez quels sont les groupes d'utilisateurs Joomla autorisés à créer de nouvelles offres et à modifier LEURS propres offres en front. Seuls les administrateurs et super administrateurs sont autorisés à modifier toutes les offres.
  
• Approbation à la création : déterminez si vous désirez que les offres nouvellement créées nécessitent l'approbation d'un administrateur ou d'un super administrateur pour être publiées, ou si vous préférez que ces offres soient automatiquement publiées sans aucun contrôle. Si vous choisissez d'imposer une approbation, un mail de notification sera alors automatiquement envoyé à l'administrateur du site.
  
• Approbation lors d'une modification : déterminez si vous désirez que lorsqu'un auteur édite une de ses offres, celle-ci soit automatiquement soumise à un contrôle d'un administrateur ou d'un super administrateur avant d'être publiée, ou si vous préférez qu'elle soit automatiquement publiée. Si vous choisissez d'imposer une approbation, un mail de notification sera alors automatiquement envoyé à l'administrateur du site.
  
• Couleur du background : vous pouvez modifier la couleur utilisée pour mettre en valeur les champs non ou mal renseignés dans le formulaire de candidature, afin de mieux l'accorder au template de votre site.
  

Valeurs par défaut

• Publié : déterminez le statut d'une nouvelle offre, publiée ou non. Si vous avez imposé l'approbation des nouvelles offres,une nouvelle offre sera alors automatiquement dépubliée. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Accès à l'offre : déterminez quels utilisateurs pourront visualiser les offres dans la partie publique de votre site, tous les visiteurs, seulement les membres ou encore uniquement les administrateurs. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Accès au formulaire de candidature : déterminez quels utilsateurs pourront accéder au formulaire de candidature des offres, tous les visiteurs, seulement les membres ou encore uniquement les administrateurs. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Saisie du mail : déterminez si dans le formulaire de candidature la saisie de l'email par le candidat est obligatoire ou facultative. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Champ "CV" : choisisser d'afficher ou de masquer le champ "CV" dans le formulaire de candidature. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Champs "Lettre de motivation" : choisissez d'afficher ou de masquer le champ" Lettre de motivation" dans le formulaire de candidature. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Saisie du CV : déterminez si un candidat doit obligatoirement joindre un CV à sa candidature ou s'il peut laisser le champ vide. Ce paramètre peut ensuite être modifié pour chacune des offres.
• Saisie de la lettre de motivation : déterminez si un candidat doit obligatoirement joindre une lettre de motivation à sa candidature ou s'il peut laisser le champ vide. Ce paramètre peut ensuite être modifié pour chacune des offres.

Création de liens de menu

Pour créer un lien vers votre composant NeoRecruit, rendez-vous dans le menu "Menu" de l'interface d'administration, puis cliquez sur le nom du menu dans lequel vous souhaitez ajouter le lien (mainmenu, topmenu, ...).

Vous accédez alors à la liste des items déjà présent dans le menu que vous avez sélectionné. Dans la barre d'outils, cliquez sur l'icône "Nouveau". Dans le cadre "Composants", cliquez sur "Composant", le premier lien dans la colonne de droite. Dans le formulaire qui s'affiche alors, entrez le nom que vous souhaitez donner à votre lien, "Offres d'emploi" par exemple, puis sélectionnez NeoRecruit dans la liste déroulante des composants. Veillez à bien publier votre lien, puis cliquez sur "Sauver" dans la barre d'outils. Votre lien est créé !

Les modules

3 modules sont disponibles en complément du composant NeoRecruit :

• NeoRecruit Latest Offers, permettant d'afficher les dernières offres créées,
  
• NeoRecruit Search Offers, qui affiche un module de recherche d'offres d'emploi,
  
• NeoRecruit Categories, affichant l'arborescence des catégories d'offres.

Les 3 modules sont disponibles gratuitement sur le portail, ils doivent être téléchargés et installés manuellement via le gestionnaire des extensions de Joomla. A noter que chaque module peut être installé indépendamment des autres.

NeoRecruit Latest Offers

Pour configurer ce module, rendez-vous dans le menu "Modules" de l'interface d'administration de votre site, puis cliquez sur "Modules du site". Dans la liste des modules installés, cliquez sur NeoRecruit Latest Offers. Vous pouvez alors, comme pour tout autre module Joomla, choisir d'afficher ou de masquer le titre, modifier sa position, définir son ordre, son niveau d'accès, le publier ou le dépublier et enfin sélectionner les pages sur lesquelles vous souhaitez voir apparaître le module.

En plus de cela, vous pouvez modifier certains paramètres propres au module :

• Le nombres d'offres : le nombre d'offres maximal qui seront affichées dans le module,
• L'ordre d'affichage : par dates croissantes, décroissantes, ou selon l'ordre déterminé dans le composant.
• Ouvrir dans : vous pouvez choisir d'afficher l'offre sélectionnée dans la fenêtre courante, ou dans une pop-up.
• Afficher le type : choisissez d'afficher ou de masquer le type des offres.
• Afficher la catégorie : choisissez d'afficher ou de masquer les catégories des offres.

NeoRecruit Search Offers

NeoRecruit Categories

Personnalisation du composant

Si vous ne parvenez pas à obtenir le rendu que vous souhaitez malgré les différentes options de personnalisation proposées dans le back-office, sachez qu'il est également possible de modifier le code HTML du composant sans toucher à son code source.

Cette technique correspond à ce que l'on appelle "surcharger" une vue ("override" en anglais) : "Catégorie", "Offre d'emploi" ou "Recherche" par exemple. Le principe consiste à créer une copie du template de la vue, qui prendra ensuite automatiquement la main sur le fichier natif du composant, et que vous pourrez librement modifier. Le principal avantage de cette solution est que vos modifications seront conservées lorsque vous mettrez à jour le composant.

Pour réaliser cette "surcharge", il vous faut tout d'abord copier le template que vous souhaitez modifier : le template "defaut.php" de la vue "Catégorie" par exemple, qui se trouve dans le répertoire "/components/com_neorecruit/views/category/tmpl/".

Vous devez ensuite coller cette copie du fichier dans votre template Joomla, dans le répertoire "/templates/<votre_template>/html/com_neorecruit/category/" (le dernier répertoire correspond ici au nom de la vue). Veillez bien à respecter cette arborescence de dossiers, autrement la surcharge ne fonctionnera pas.

Enfin, il ne vous reste plus qu'à ajuster le contenu du nouveau fichier, pour y personnaliser le code HTML selon vos besoins.

Sachez également que cette technique est valable pour tous les composants Joomla! respectant la modélisation MVC.

Un besoin spécifique ?

Vous n'avez pas trouvé la réponse à votre question sur cette page ? N'hésitez pas à nous contactez, nous reviendrons vers vous dans les meilleurs délais.