Writing from the frontend to the backend

[antoine3000]

Good morning,

Is it possible to write data from frontend to backend with this setup? If not, what would you suggest for saving data from a form?

Thanks, A

[johannschopplich]

Sure! As an example, let's upate the author field of a given page.

In your backend, create a plugin that provides an API route:

// site/plugins/yourplugin/index.php
<?php

use Kirby\Cms\App;

App::plugin('yourname/yourplugin', [
    'api' => require __DIR__ . '/extensions/api.php'
]);

// site/plugins/yourplugin/extensions/api.php
<?php

use JohannSchopplich\Headless\Api\Api;
use JohannSchopplich\Headless\Api\Middlewares;
use Kirby\Cms\App;

return [
    'routes' => function (App $kirby) {
        return [
            [
                'pattern' => 'yourplugin/updatePage',
                'method' => 'POST',
                // Disable auth for this route, because we use the bearer token middleware
                'auth' => false,
                'action' => Api::createHandler(
                    // Check if the request has a valid bearer token
                    [Middlewares::class, 'hasBearerToken'],
                    // Execute the action only if the bearer token is valid
                    function () use ($kirby) {
                        $body = $kirby->request()->body();
                        $id = $body->get('id');
                        $page = $kirby->page($id);

                        if (!$id || !$page) {
                            return Api::createResponse(404);
                        }

                        $kirby->impersonate('kirby', function () use ($page) {
                            $page->update([
                              'author' => 'Homer Simpson'
                            ]);
                          });

                        return Api::createResponse(201, [
                            'result' => 'ok'
                        ]);
                    }
                )
            ]
        ];
    }
];

---

In the frontend, we can use the $kirby composable (not documented yet...), which is a simple $fetch wrapper that will provide this same functionality as useKql: server proxy to hide your credentials.

const id = 'home'
const { result } = await $kirby('api/yourplugin/updatePage', {
  method: 'POST',
  body: {
    id,
  },
})

Of course, wrap this request in try/catch to make sure you catch any errors, for example, if the page can't be found.

Hope that helps!

[antoine3000]

Fantastic, thank you! I'll try it now. And thanks again for the great starter kit, i love it.

[antoine3000]

@johannschopplich It works like a charm, thanks again!