Afficher les données dans Wordpress avec crocoblock JetEngine

En utilisant les plugins JetEngine de crocoblock, vous pouvez facilement afficher les données de notre logiciel sur votre site WordPress.

Procédez comme suit :

Préparation

1. Demandez un jeton non expirant via notre interface REST (fonction : /nonexptoken). Vous pouvez utiliser Swaggersur notre interface ou Postman pour cela.
2. Achetez le plugin JetEngine de crocoblock et installez-le dans votre WordPress.

Créer un point d'accès API REST

Suivez la description How to set the connection between two websites using the REST API ? sur la page JetEngine : How to Display Custom Content Type Items Using REST API et utilisez les informations suivantes :

1. API Endpoint URL : https://api.beyond-sw.ch/kurse (ou remplacez kurse par une autre entité de notre interface.
2. Items path : value
3. Autorisation : Oui
4. Type d'autorisation : Bearer Token
5. Bearer token : Insérez le token que vous avez reçu lors de la préparation à l'étape 1.

Notez que

Pour des raisons de performance et de mémoire, il est préférable de limiter la quantité de données à interroger via $selectet/ou $filter dans l'URL.

Par exemple :

/Kurse?$select=kursId,titel&$filter=istAnmeldungMoeglich eq true

De plus, il peut être nécessaire d'ajuster le pagesize pour que plus de 100 entrées soient renvoyées via l'interface.

Par exemple :

/Kurse?$select=kursId,titel&$filter=istAnmeldungMoeglich eq true&pagesize=500

Créer une requête avec Query Builder

Suivez la description How to Set Up REST API Query Type ? sur la page JetEngine : Query Builder REST API Query Type et utilisez les informations suivantes :

1. Query Type : REST API Query
2. From Endpoint : Nom du point de terminaison créé précédemment
3. Query :
1. Key : OData keyword (par ex. $select, $filter, $orderby)
2. Value : Expression OData

Notez que

Pour des raisons de performance et d'espace mémoire, il est utile d'utiliser $select et/ou $filter dans l'URL pour limiter la quantité de données à interroger.

Dans la description Créer une requête avec Query Builder, utilisez les paramètres $select et/ou $filter pour Query Key et Value.

De plus, il peut être nécessaire d'ajuster pagesize pour que plus de 100 entrées soient renvoyées via l'interface.

Utiliser des paramètres de chaîne de requête dans une requête

Pour pouvoir filtrer une requête avec des valeurs provenant d'une chaîne de requête, procédez comme suit :

1. Pour la clé $filter, sélectionnez Value Query Variable.
2. Sous Advanced settings, composez l'expression du filtre OData sous Before et After.

Utilisez par exemple le plugin Code Snippets pour insérer ce code :

add_filter( 'jet-engine/rest-api-listings/request/query-args', function( $query_args ) {

    foreach ( $query_args as $index => $value ) {
        $query_args[ $index ] = wp_specialchars_decode( stripslashes($value), ENT_QUOTES ) ;
    }
    return $query_args ;    
} ) ;

Créer une sub query avec Query Builder

Suivez la description Set Up a Sub Query to Retrieve the Array of Objects sur la page JetEngine : How to Display Array Elements from REST API Endpoint Using Sub Query Addon et utilisez les informations suivantes :

1. Query Type : Sub Query
2. Parent Object Property : nom de la NavigationProperty de la requête du listing englobant (définir $expand dans la requête englobante).
3. Dans le schéma d'items, créez une entrée pour chaque propriété que vous souhaitez utiliser dans le listing imbriqué.

Notez que

Pour des raisons de performance et d'espace mémoire, il est utile d'utiliser $select et/ou $filter dans l'URL pour limiter la quantité de données à interroger.

Dans la description Créer une requête avec Query Builder, utilisez les paramètres $select et/ou $filter pour Query Key et Value.

De plus, il peut être nécessaire d'ajuster pagesize pour que plus de 100 entrées soient renvoyées via l'interface.

Créer un lien dynamique

Si vous souhaitez créer un lien dans un listing basé sur le Query Builder qui utilise un champ du Query Builder comme élément de l'url, procédez comme suit :

1. Créez une page d'options (sous JetEngine -> Options Page) et utilisez les paramètres suivants, différents des options par défaut :
1. Page title : Nom libre, par exemple lien de connexion.
2. Menu name : Nom libre, par ex. lien de connexion
3. Menu position : Choix libre
4. Insérez un champ :
1. Label : Nom à choisir librement, par exemple Url
2. Naviguez jusqu'à la position que vous avez choisie au point 1.3.
3. Saisissez dans le champ l'url complète qui doit précéder la partie dynamique. PAR EXEMPLE , https://test.ch/anmeldung/
4. Allez dans le générateur de shortcode (sous JetEngine -> Shortcode Generator) et sélectionnez les options suivantes :
1. Source : Post/Term/User/Object Data
2. Title : sélectionnez dans l'API REST le champ (l'API REST sur laquelle la requête est basée, sur laquelle le listing est basé) que vous voulez ajouter dynamiquement dans l'url.
3. Copiez le shortcode généré.
5. Passez au générateur de macros et sélectionnez les options suivantes :
1. Macros : Shortcode result
2. Shortcode : Collez le shortcode copié au point 4.3.
3. Copiez la macro générée
6. Dans votre listing, ajoutez un lien dynamique et définissez les options suivantes :
1. Source : Options
2. Option : Nom que vous avez choisi sous 1.1.
3. Add Query Arguments : Oui
4. Query Arguments : Entrez le nom de la variable de requête désirée suivi d'un signe = suivi de la macro copiée en 5.3 : par exemple _kursId=%shortcode_result|[jet_engine_data dynamic_field_post_object=« kursId »]%.