Add segmnt to Moodle

​

Before you start

1. Your video is ready (vid_...). See Manage videos.
2. The Moodle site’s host, for example moodle.example.com, is a verified domain of the project. See Accounts, projects, API keys and domains.
3. A playback API key (sk_...) is stored on the Moodle server, ready for the token step. Create a playback key in the segmnt dashboard; it can only make playback tokens.

​

1. Let iframes into course content

Moodle’s editor may also tidy pasted code. If the iframe code vanishes while you type, use the editor’s HTML / source view (</> in the toolbar) to paste the block.

​

2. Add the video to a course page

1. Make a playback token for the video and your Moodle host, with the cURL call from Create playback tokens on your server.
2. Edit the Label, Page or HTML block, open the HTML/source view, and paste:

<div style="position:relative;width:100%;aspect-ratio:16 / 9;">
  <iframe src="https://cdn.segmnt.cloud/e/vid_9xR4tL?token=YOUR_PLAYBACK_TOKEN"
    title="segmnt video" loading="lazy"
    style="position:absolute;inset:0;width:100%;height:100%;border:0;"
    allow="autoplay; fullscreen; picture-in-picture; encrypted-media"
    allowfullscreen referrerpolicy="origin"></iframe>
</div>

3. Replace vid_9xR4tL with your video id and YOUR_PLAYBACK_TOKEN with the real token.
4. Save and view the page as a student would. The video plays only on the verified host, so a look at the page as a real user is the check that matters.

​

3. A fresh token on every page load

[[segmnt:vid_9xR4tL]]

<?php
// filter/segmnt/filter.php — a minimal Moodle text filter.
// Install as filter/segmnt, enable it in Site administration -> Plugins ->
// Text filters, then write [[segmnt:vid_...]] in any course text.

class filter_segmnt extends moodle_text_filter {
    public function filter($text, array $options = []) {
        if (strpos($text, '[[segmnt:') === false) {
            return $text;
        }
        return preg_replace_callback('/\[\[segmnt:([A-Za-z0-9_-]+)\]\]/', function ($m) {
            return $this->segmnt_iframe($m[1]);
        }, $text);
    }

    private function segmnt_iframe(string $videoid): string {
        $key     = get_config('filter_segmnt', 'apikey');   // set on the plugin's settings page
        $project = get_config('filter_segmnt', 'projectid');
        $host    = parse_url(config::wwwroot(), PHP_URL_HOST); // the verified domain

        $curl = new curl();
        $res = $curl->post(
            'https://api.segmnt.cloud/v1/projects/' . $project . '/videos/' . $videoid . '/playback-tokens',
            json_encode(['domain' => $host]),
            ['CURLOPT_HTTPHEADER' => [
                'Authorization: Bearer ' . $key,
                'Content-Type: application/json',
            ], 'CURLOPT_TIMEOUT' => 10],
        );
        $data = json_decode($res, true);
        $token = $data['token'] ?? '';
        if ($token === '') {
            return '<!-- segmnt: could not create a playback token -->';
        }

        $src = 'https://cdn.segmnt.cloud/e/' . rawurlencode($videoid) . '?token=' . rawurlencode($token);
        return '<div style="position:relative;width:100%;aspect-ratio:16 / 9;">'
            . '<iframe src="' . s($src) . '" title="segmnt video" loading="lazy"'
            . ' style="position:absolute;inset:0;width:100%;height:100%;border:0;"'
            . ' allow="autoplay; fullscreen; picture-in-picture; encrypted-media"'
            . ' allowfullscreen referrerpolicy="origin"></iframe></div>';
    }
}

• The API key lives in the plugin’s admin settings (a site administrator pastes it once, like the WordPress plugin does), never in a course page or a code comment in a lesson.
• The domain comes from the server (wwwroot), not from the page, so a page author cannot pick another domain.
• The HTTP call is the same POST .../playback-tokens call shown in Create playback tokens on your server. That route, its answer shape (token, expiresAt, embedUrl) and the key rules are covered by the API tests.

Caching. Moodle caches the output of text filters, and your host may cache whole pages. A cached page serves an old token, and the video stops when the token expires. Before you rely on the filter in a live course, check the caching section of the Moodle filter plugin documentation and keep any page-cache lifetime under about 4 hours, as in the WordPress guide.

​

Common problems

​

Where to go next

• Embed a video on any website
• Create playback tokens on your server
• Add segmnt to WordPress: the same two paths, on WordPress.

​

Tested against the current release

• The embed block is the same markup the dashboard’s Copy code box builds: /e/{videoId}?token=…, the allow list, referrerpolicy="origin" and the responsive wrapper.
• GET https://cdn.segmnt.cloud/segmnt-player.js → 200; GET /e/{videoId} with no token → 403 token_missing (checked on the TEST deploy).
• The filter’s HTTP call is the same playback-tokens request as the cURL example, which the API tests cover.
• Unverified: the filter class itself has not run on a Moodle install — the TEST environment has no Moodle site yet. The Moodle-specific parts (plugin settings, the moodle_text_filter shape, filter output caching) follow the Moodle filter plugin documentation. Verify section 1 and 2 on your Moodle site before a live course, and treat section 3 as a starting point, not a finished plugin.