Daten in Wordpress anzeigen mit crocoblock JetEngine

Mit Hilfe der JetEngine Plugins von crocoblock können Sie einfach Daten aus unserer Software auf Ihrer WordPress Seite anzeigen.

Gehen Sie wie folgt vor:

Vorbereitung

1. Fordern Sie über unsere REST-Schnittstelle (Funktion: /nonexptoken) einen nicht verfallenden Token an. Sie können dafür Swagger auf unserer Schnittstelle oder Postman verwenden.
2. Kaufen Sie das Plugin JetEngine von crocoblock und installieren Sie es in Ihrem WordPress.

Erstellen eines REST API Endpoints

Gehen Sie gemäss Beschreibung How to set the connection between two websites using the REST API? auf der Seite JetEngine: How to Display Custom Content Type Items Using REST API vor und verwenden Sie folgende Angaben:

1. API Endpoint URL: https://api.beyond-sw.ch/kurse (oder ersetzen Sie kurse durch eine andere Entität unserer Schnittstelle.
2. Items path: value
3. Authorization: Ja
4. Authorization type: Bearer Token
5. Bearer token: Setzen Sie den Token ein, den Sie bei der Vorbereitung in Schritt 1 erhalten haben.

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

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

Erstellen einer Query mit Query Builder

Gehen Sie gemäss Beschreibung How to Set Up REST API Query Type? auf der Seite JetEngine: Query Builder REST API Query Type vor und verwenden Sie folgende Angaben:

1. Query Type: REST API Query
2. From Endpoint: Name des vorher erstellen Endpoints
3. Query:
   1. Key: OData Schlüsselwort (z.B. $select, $filter, $orderby)
   2. Value: OData Ausdruck

Verwenden von Querystring-Parameter in einer Query

Um eine Query mit Werten aus einem Querystring filtern zu können, gehen Sie wie folgt vor:

1. Wählen Sie beim $filter-Key als Value Query Variable
2. Unter Advanced settings setzen Sie bei Before und After den OData-Filter-Ausdruck zusammen

Verwenden Sie z.B. das PlugIn Code Snippets um diesen Code einzufügen:

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;    
} );

Erstellen einer Sub Query mit Query Builder

Gehen Sie gemäss Beschreibung Set Up a Sub Query to Retrieve the Array of Objects auf der Seite JetEngine: How to Display Array Elements from REST API Endpoint Using Sub Query Addon vor und verwenden Sie folgende Angaben:

1. Query Type: Sub Query
2. Parent Object Property: Name der NavigationProperty der Query des umschliessenden Listings ($expand in der umschliessenden Query definieren)
3. Erstellen Sie im Item Schema für jede Property, die Sie im verschachtelten Listing verwenden wollen, einen Eintrag

Dynamischen Link erstellen

Wollen Sie in einem auf auf dem Query Builder basierenden Listing einen Link erzeugen, der als Bestandteil der Url ein Feld aus der Query Builder verwendet, dann gehen Sie wie folgt vor:

1. Erstellen Sie eine Options Page (unter JetEngine -> Options Page) und verwenden Sie folgende von den vorgegebenen Optionen abweichenden Einstellungen:
   1. Page title: Frei zu wählender Name, z.B. AnmeldeLink
   2. Menu name: Frei zu wählender Name, z.B. AnmeldeLink
   3. Menu position: Frei wählbar
   4. Fügen Sie ein Feld ein:
      1. Label: Frei zu wählender Name, z.B. Url
2. Navigieren Sie zu der Position, die Sie unter 1.3. gewählt haben
3. Erfassen Sie im Feld die gesamte Url, die vor dem dynamischen Teil stehen soll. Z.B. https://test.ch/anmeldung/
4. Wechseln Sie zum Shortcode Generator (unter JetEngine -> Shortcode Generator) und wählen Sie folgende Optionen:
   1. Source: Post/Term/User/Object Data
   2. Title: wählen Sie aus dem REST API das Feld(die REST API, auf der das Query basiert, auf dem das Listing basiert), das Sie in der Url dynamisch zufügen wollen
   3. Kopieren Sie den generierten Shortcode
5. Wechseln Sie zum Macros Generator und wählen Sie folgende Optionen:
   1. Macros: Shortcode result
   2. Shortcode: Fügen Sie den unter 4.3. kopieren Shortcode ein
   3. Kopieren Sie das generierte Makro
6. In Ihrem Listing fügen Sie ein Dynamic Link zu und setzen folgende Optionen:
   1. Source: Options
   2. Option: Name, den Sie unter 1.1. gewählt haben
   3. Add Query Arguments: Yes
   4. Query Arguments: Geben Sie den Namen der gewünschten QueryVariable gefolgt von einem = Zeichen gefolgt von dem unter 5.3. kopierten Makro: z.B. 

      _kursId=%shortcode_result|[jet_engine_data dynamic_field_post_object="kursId"]%