Widget - La Bonne Immersion

Présentation

Le widget La Bonne Immersion permet de récupérer la liste des entreprises pour un métier (code ROME) et pour une localisation donnée. Il permet d’intégrer sur votre site web un module de recherche d'entreprises pouvant accueillir des stagiaires en immersion. Il est conseillé d'accompagner ce module de recherche d'une présentation de l'immersion professionnelle (par exemple l'immersion professionnelle mode d'emploi ) et de conseils pour aider les utilisateurs à faire une demande. Le widget propose en téléchargement le formulaire CERFA permettant de contracter une immersion entre le bénéficiaire, l'entreprise d'accueil et le prescripteur et une plaquette de conseils pour aider les utilisateurs à faire une demande.

Il existe en deux formats (horizontal, vertical) et supporte tous les navigateurs modernes (Firefox 32+, Chrome 37+, Opera 30+, Safari OS X, Internet Explorer 11+).

Vous pouvez consulter des exemples d'intégration du widget à l'url suivante https://labonneformation.pole-emploi.fr/demo-widget

Il s'agit d'une première version du widget, des évolutions sont possibles. N'hésitez pas à nous faire part de vos retours.

 

Pré-requis

Le widget est couplé à l’API La bonne boite - liste des entreprises classées par potentiel d'embauche pour un métier. Il est donc nécessaire de remplir les conditions suivantes :

  1. Se créer un compte sur l’Emploi Store Développeurs
  2. Demander l'accès à l’API La Bonne Boîte et consentir à son contrat de licence
  3. Être en mesure de faire des appels sur l’API La Bonne Boîte :

 

Options

En plus de l'affichage des entreprises, il est possible d'activer des options dans le widget

data-lieu

L'option data-lieu permet de pré-remplir le formulaire avec un lieu de recherche, afin d'afficher directement une liste d'entreprises.

Si cette option est renseignée, l'option data-metier doit aussi l'être.

L'utilisateur pourra toujours modifier le métier et le lieu de recherche dans le formulaire.

Le format utilisé pour le lieu est le nom du lieu (ville, département, région) en ASCII, les espaces remplacés par les tirets ("slug"). Il est suivi du code de département pour les villes et les départements.

Ex: marseilles-les-aubigny-18 pour la ville Marseilles lès Aubigny (18), loire-atlantique-44 le département Loire-Atlantique (44) ou pays-de-la-loire pour la région Pays de la Loire.
 

data-metier

L'option data-metier permet de pré-remplir le formulaire avec un métier, afin d'afficher directement une liste d'entreprises.

Si cette option est renseignée, l'option data-lieu doit aussi l'être.

L'utilisateur peut toujours modifier le métier et le lieu de recherche dans le formulaire.

Le format utilisé pour le métier est le libellé du ROME, en minuscule et en ASCII, l'espace remplacé par des tirets ("slug").
Ex : coiffure-et-maquillage-spectacle pour Coiffure et maquillage spectacle (ROME : L1501) ou assistance-aupres-adultes pour Assistance auprès d'adultes (ROME : K1302).
 

data-format

L'option data-format permet de choisir entre le format horizontal et vertical pour le widget.

Si elle n'est pas renseignée, c'est le format horizontal qui est utilisé.
 

Configuration du widget

Insérez la balise suivante de préférence dans la balise <head> de votre document HTML.

<script src="https://labonneformation.pole-emploi.fr/js/inc/widget_immersion_loader.js"></script>

 

Positionner le code suivant à l'emplacement où vous souhaiter afficher le widget dans votre page HTML:

<div class="immersion-widget" data-metier="" data-lieu="" data-format=""></div>

 

Paramétrage des données

Champ Description  
metier

ex : coiffure

Optionnel
lieu

ex : nantes-44

Optionnel
format

horizontal ou vertical

Optionnel

 

Exemples

Affichage au format horizontal

<div class="immersion-widget" data-metier="" data-lieu="" data-format="horizontal"></div>

 

Affichage au format vertical

<div class="immersion-widget" data-metier="" data-lieu="" data-format="vertical"></div>"

 

Affichage avec un métier et un lieu pré-remplis

<div clas="immersion-widget" data-metier="coiffure" data-lieu="nantes-44" data-format=""></div>"