WebTV-For-Streamlike Documentation

Contents

1. Before you start
2. Installing and connecting the site to Streamlike
3. Preparing your videos in Streamlike
4. Organising: tag families and rows
5. Placing the WebTV on a page
6. Adjusting the WebTV: attributes
7. Building the page from blocks
8. What does not combine
9. What visitors see
10. Keeping content up to date
11. Completing video records
12. Tracking the audience
13. Customising the appearance
14. Buttons, links and footer
15. Privacy
16. Frequently asked questions

Before you start

You need:

• WordPress 6.4 or later, with PHP 7.4 or later;
• a Streamlike account and an API key for that account;
• your videos filed in one or more Streamlike playlists: each playlist becomes a channel of the WebTV.

The plugin works with any theme and with page builders such as Oxygen or Elementor.

One principle to keep in mind.
Your pages never contact Streamlike. The plugin fetches the catalogue from the admin area and keeps it in WordPress; visitors read that copy. A change made in Streamlike therefore only shows on the site after a refresh — by hand, or automatically.

Installing and connecting the site to Streamlike

Installing the plugin

1. In WordPress, open Plugins → Add New Plugin → Upload Plugin.
2. Choose the file webtv-for-streamlike-1.29.0.zip — the one carrying the version number, not the delivery archive that contains it — then Install Now.
3. Click Activate. A WebTV for Streamlike menu appears in the left-hand column.

The plugin's admin area has five tabs: Settings, Content, Appearance, Records to complete and Audience. Only the site's administrators can reach it.

In Settings as in Appearance, sections are arranged in panels that open with a click — Streamlike access, Your channels, Sorting and filters, Playback, Footer, Integration, Licence and updates, Maintenance. The One panel open at a time box closes the others when you open one; unticked, Expand all opens them all. The panel you were working in reopens after saving.

Connecting the site to Streamlike

In WebTV for Streamlike → Settings, section Streamlike access:

1. API key — create it in the Streamlike back office, avatar menu → API/FTP keys, of type “api”, and paste it here. Once saved, it is never displayed in full again: only its last four characters remain visible. Leaving the field empty keeps the current key. It is used by the server only and never sent to visitors' browsers.
2. Click Save. Your Streamlike account's list then appears by itself, with each playlist's name, number of videos and duration.
3. Tick the playlists that will become the WebTV's channels, then Save again. The videos of the ticked channels are fetched right away: the message tells you how many.

That's all: key, ticks, save. Two buttons remain for special cases — Refresh the list, after creating a playlist in Streamlike, and Content → Refresh the catalogue, after changing videos.

Several playlists ticked: together or in tabs? The setting just below decides.

• All together — a single view gathers every video, with a Channel filter to keep just one. This is the portfolio choice, and the one the Portfolio formula uses.
• In tabs — one tab per playlist, each showing only its videos. This is the choice for two brands on one site.

In tabs, the order of the list is the order of the tabs, and the first ticked playlist is the one that opens when a visitor arrives on the page. With a single ticked playlist, this setting changes nothing.

A playlist with no video at all is not offered for ticking: it is simply listed below, as a reminder to tidy up in Streamlike if you wish.

Update the list reads it again from Streamlike: a playlist created since then appears, without changing your ticks. A ticked playlist that has disappeared from the account stays visible, flagged “Not in the fetched list”, so that you can untick it knowingly.

⚠️ After ticking a new playlist, refresh the catalogue.
Until its videos have been fetched, the channel shows empty on the site. The plugin tells you: a warning at the top of its admin area, and a message on the page, visible to administrators only.

Only ticked playlists exist for the WebTV.
A playlist that is not ticked is not fetched: a shortcode asking for it would stay empty.

Preparing your videos in Streamlike

The WebTV shows what your Streamlike records contain. The better they are filled in, the richer the channel.

After each batch of changes in Streamlike, refresh the catalogue.

Organising: tag families and rows

Choosing a formula

Before any fine tuning, Settings → Sorting and filters offers four formulas. A formula decides how your videos are arranged and what visitors are given to find their way.

A hint tells you what the formula will find: “Your catalogue carries 16 tags, 5 of them on at least three videos”.

Changing formula destroys nothing: families you built by hand stay saved, and “Custom” finds them unchanged. An existing site keeps exactly what it showed.

Tag families (advanced setting)

Used by the Custom formula, and by it alone. A family says what a group of tags becomes on the WebTV: a filter, with its own name and presentation. They are set in Settings → Tag families, with one card per family:

• Displayed name — what visitors read: “Destination”, “Software”, “Theme”…
• Presentation — a Drop-down list, handy for many values, or Buttons showing the number of videos, for a few values;
• Tags gathered — **“Everything else (\*)”, which takes every tag no other family claims, including tags added later; or Tags picked one by one**, offered as checkboxes from your catalogue, with the number of videos for each;
• On which playlists — to reserve a family for some channels. A portfolio and a catalogue of stays do not share a vocabulary: each tab only shows the families that concern it. No box ticked: the family applies everywhere.

The Add a family button creates a new card; the cross deletes one. The tags offered are those of the last catalogue fetched: after adding tags in Streamlike, refresh the catalogue to see them here.

The builder stays folded while a ready-made formula is chosen.
Under “Portfolio”, “Themed channel” or “Travel and places” it would have no effect: in its place, one line recalls what stays saved, and a Show my families anyway link opens it for reading. It opens by itself as soon as you choose “Custom”.

No family at all is a valid setting: the WebTV then shows every video in a single mosaic, with no filter — and that is exactly what gets saved. An Install the “Destination / Season” example button puts the two original families back in one click.

The first family is the primary one.
Marked Primary, it divides the channel into rows and places the dots on the map. The following ones only filter. Reorder families with the ↑ ↓ arrows.

The primary family is decided channel by channel: it is the first family that concerns the playlist on display. If “Client” is reserved for one channel and “Theme” for the other, each is the primary family of its own.

An Edit as text link gives access to the same setting as lines of text, for anyone who prefers pasting a list: one family per line, with the name, liste or boutons, the tags (or *), and optionally playlist identifiers, separated by vertical bars.

Destination | liste | *
Season | boutons | printemps, été, automne, hiver
Software | boutons | Photoshop, Final Cut Pro | 0f1e2d3c4b5a6978

Video order

Settings → Sorting and filters → Video order decides the order everywhere: in every row, in the mosaic, in the grid and in the suggestions under the player.

⚠️ Your playlist's order does not always come back from Streamlike.
The API gives a “position” per video, but it is often the same number for every video of a playlist — measured on 27 September 2026. Sorting then falls back to the title, with nothing saying so. If your manual order matters, pick one of the other orders explicitly.

The by date and by plays orders need a catalogue refresh: that is what fetches those two pieces of information from Streamlike.

Letting visitors sort

Settings → Sorting and filters → Sorting offered to visitors adds a Sort menu to the page: none (the default), at the top of the page, or at the top of the page and on every row. You then tick the sorts offered — title, most recent, most watched, random; visitors always find “Site order” at the top of the list to come back to yours.

With the third choice, each row carries its own menu: you can ask for “most recent” on one row and leave the others alone. A choice made at the top of the page brings every row back in line with it.

What goes into the page. Sorting happens in the browser: the release date travels as it is, and for “most watched”, only a rank, never the number of plays. Offering that sort amounts to publishing that order — which is the point of the setting — but the counters themselves stay on the server.

Rows

By default, each value of the primary family forms its own row, in alphabetical order: one row per value. Videos with no value in that family end up in a last row, Other videos.

To gather several values under one title, go to Settings → Row groupings. The Add a grouping button creates a card: a row title, then the values to gather in it, as tick boxes from your catalogue, with each one's number of videos. The ↑ ↓ arrows order the rows, the cross deletes one. A value already taken by another row is still offered, greyed out: it will then appear in both.

An Edit as text link gives the same setting as lines, for those who would rather paste a list — one row per line, as “title | value, value…”:

Northern Alps | Vercors, Chartreuse Belledonne, Pays du Mont Blanc – Val d'Arly
Pyrenees | Pays Basque, Hautes-Pyrénées

Capitals, accents and dash types do not matter. Rows follow the order you give them. A misspelt value is ignored; if none matches, the plugin falls back to automatic rows.

When it is the only row on the page, it takes the name of what was asked for — the filtered value, or the search: “Other videos” means nothing when there are no others.

Nothing is lost, and nothing appears twice. A video no grouping took joins a last Other videos row, along with those carrying no value at all. A video already placed is not in it: that row gathers unplaced videos, not forgotten values. If it is large, values are still waiting to be listed — often a whole channel's worth. With groupings entered, the primary family's drop-down list also groups its values under each row's name.

⚠️ Row groupings apply to every channel.
On a site with several channels, a grouping that lists only one channel's values leaves every video of the other in “Other videos”. To give it its rows, list its values too, for instance Sport | Sport and Tutorials | Tuto. Or leave the groupings empty: each value then forms its own row, everywhere.

Reels are never split into rows: they are all shown together, in one vertical grid. And for a small playlist, where rows would hold only one or two videos, prefer one single big grid: disposition="mosaique".

Placing the WebTV on a page

Create or open a page. There are two ways to place the WebTV:

• in the WordPress editor, add the Full WebTV block: type /webtv to find it at once, or look for the WebTV for Streamlike section of the inserter;
• everywhere else — Oxygen, Bricks, Divi, Elementor, a widget, a theme template —, write the shortcode:

[webtv]

The element is called Shortcode in Oxygen, in Elementor and in WordPress's block of the same name. Both routes do exactly the same thing. The published page shows the whole WebTV, across the full window width, in this order:

1. the band: the title, if any, the channel tabs and, for administrators, the review-mode checkbox;
2. the player and the video details;
3. “More like this”;
4. the filter bar, in three groups that wrap as a block when space runs short: what you watch (Films or Reels, search), what you filter (tag families, Clear all), and the end of the line (Sort, Map, counter);
5. the map panel, closed until opened;
6. the rows of thumbnails;
7. the footer.

To arrange these pieces differently — the player in one column, the map in another section —, see blocks.

One WebTV per page.
A second [webtv], or a [webtv] added to a page that already contains blocks, is not displayed. Logged in as an administrator, you see a message in its place explaining why; visitors see nothing.

Adjusting the WebTV: attributes

A shortcode accepts attributes, written after its name, each followed by an equals sign and a value in straight quotes. Their order does not matter, and several can be combined:

[webtv playlist="a1b2c3d4e5f60718" titre="Our video channel" largeur="contenu"]

Straight quotes.
Type ", not “ ”. Some editors replace quotes as you type: an attribute in curly quotes is ignored, and the WebTV falls back to its default.

In the WordPress editor, these settings are in the sidebar on the right.
Nothing to type, no quotes to watch out for, and the list of your actual channels instead of their identifiers. See Building the page from blocks.

playlist — one page per channel

[webtv playlist="a1b2c3d4e5f60718"]

The page only shows that playlist's videos. The channel tabs disappear by themselves, since they would offer no choice, and only that channel's tag families are offered.

• The identifier must appear, ticked, in Settings → Playlists. Otherwise the WebTV stays empty, and a message tells administrators so — naming the requested playlist. This is the classic trap when you change channels without touching your pages: unticking a playlist does not change the shortcodes that name it.
• A direct link to a video from another playlist does not work on this page: the video is not there.
• Everything else — families, groupings, appearance, buttons — is still set once for the whole site.

titre — the name in the band

[webtv titre="Our video channel"]

The text appears to the left of the channel tabs. Without a title, on a page devoted to a single playlist, the whole band disappears for visitors: it would have nothing left to show.

disposition — rows, grid or mosaic

Two separate questions: are videos grouped into titled rows, and do a group's thumbnails scroll or wrap onto new lines?

In rows and grid, the groups are the values of the primary family, or your groupings.

When to use what.

• mosaique — small playlists, where rows of one or two videos would break the page into pieces; a portfolio; any channel where sorting by theme adds nothing visually. Filters, search and the map keep working: they simply narrow the mosaic down.
• grille — long rows you want to show in full, without horizontal scrolling, while keeping their titles.
• rangees — a compact page that scrolls even beyond twelve videos per group.
• auto — let the plugin decide: suits most sorted catalogues.

⚠️ grille does not remove rows.
On short groups — fewer thumbnails than fit across the screen, three or four on a computer —, a scrolling row and a grid look identical: nothing overflows. For a page without rows, use mosaique.

No layout affects Reels, always shown as one vertical grid. The accent is tolerated: mosaïque works too.

largeur — the whole window or the theme's width

[webtv] defaults to pleine; blocks default to contenu. Choose contenu when the WebTV shares the page with a sidebar, or inside a builder section whose width you set yourself.

texte — the footer credit, for this page

[webtv texte="Filmed by Example Studio, 2026"]

Replaces, on this page only, the credit set in Settings → Footer credit. An attribute cannot hold a link: its quotes would close the attribute. For a link, the safest route is the general setting. You can also enclose the text:

[webtv]Filmed by <a href="https://example.com">Example Studio</a>[/webtv]

⚠️ Oxygen damages enclosed text.
Observed under Oxygen: text placed between [webtv] and [/webtv] does not arrive intact. With that builder, use the Footer credit setting.

historique — the clear button

[webtv historique="non"]

By default, a visitor who has started videos sees a Clear my watching progress button in the footer. non removes it. The progress stays stored in their browser; they simply can no longer clear it from the page.

Building the page from blocks

The WebTV also comes as eight blocks, one per piece, to place wherever you like on the page: the player at the top left, the filters in a column, the map in a section further down. Together they form a single WebTV: they find and answer each other, even far apart.

Three attributes can sit on any block:

• playlist and disposition apply to the whole page. Put them once, on the block of your choice — on [webtv_chaines], for instance;
• largeur is set block by block, contenu by default. Add largeur="pleine" to a block that must take the whole window.

In the WordPress editor: the blocks

The nine bricks — the whole WebTV and its eight parts — are also blocks of the WordPress editor, gathered in their own WebTV for Streamlike section of the inserter. Type / followed by the brick's name, /map for instance, to get there faster.

Once placed, a block's settings are in the sidebar on the right: the list of your actual channels, the layout, the width, the footer credit. No playlist identifier to copy out.

A block you leave alone follows your settings.
Every setting in the sidebar starts at “Same as the site settings”, or “Default: …” for the width. As long as you leave it there, the brick behaves exactly like the bare shortcode, and a change made later in the settings shows on the page at once. Only fill in what you want to do differently here.

The rules are unchanged: one WebTV per page, each brick only once, and the bricks do not mix with the Full WebTV block.

Starting from a pattern

The Patterns tab of the inserter offers three ready-made pages, under WebTV for Streamlike:

Once placed, a pattern is nothing but ordinary blocks: remove, add, move whatever you like. Nothing will ever take you back to the model.

An example of a composed page

In a builder, three sections:

Section 1, full width:  [webtv_chaines titre="Our videos" playlist="a1b2c3d4e5f60718"]
Section 2, two columns: [webtv_lecteur]  on the left,  [webtv_veine]  on the right
Section 3:              [webtv_filtres] [webtv_carte] [webtv_rangees] [webtv_pied]

Place [webtv_carte] near [webtv_filtres]: that is where the button opening it lives. When an action changes a distant block — choosing a thumbnail at the very bottom of the page, for instance —, the WebTV scrolls the page to it.

In the editor: the mock-up

A page builder does not run the WebTV in its editor: it loads neither its styling nor its script there. Each block therefore shows a mock-up in the editor: a simplified drawing, roughly at its real size and in your colours, carrying the block's name, its shortcode and the attributes that change something (playlist, disposition, largeur, titre…). Enough to lay out the page while seeing the volumes. The real WebTV shows on the published page, or in the site preview.

The mock-up appears in the WordPress editor — that is what its blocks show —, in Oxygen, Elementor, Bricks, Beaver Builder and Divi, and in principle in any builder that prepares its previews in the background. It is only shown to people who can edit pages: visitors never see it. The Shortcode block, on the other hand, only shows the shortcode's text.

Block rules

• Each block appears only once per page. A duplicate block is not displayed; an administrator sees a message in its place.
• Blocks and [webtv] do not mix on the same page: it is one or the other.
• A missing block makes its feature inert, without breaking anything. Without [webtv_carte], the Map button disappears. Without [webtv_pied], no credit.
• Blocks inherit the appearance set in the Appearance tab, wherever they are.

Blocks that depend on each other

Some blocks only make sense together. Nothing breaks without them, but part of the WebTV becomes unreachable:

What does not combine

The limits worth knowing, gathered in one place.

What visitors see

• Channel tabs, one per playlist, and two formats: Films and Reels, with their number of videos. A format with no videos in a channel is greyed out. On arrival, a video is loaded in the player, without starting: which one is set in Settings → Playback → Opening video.
• Settings → Playback → Opening video decides which one sits in the player on arrival: the first of the playlist (Streamlike's order, the original behaviour), the first of your “Also worth watching” selection, the most recently released, the most watched, or one at random on each visit. The choice applies channel by channel and format by format: each tab opens on its own video, and Reels on theirs.

> The most recent and most watched orders come from Streamlike: after choosing one, refresh the catalogue so the date and the counter are fetched. The play count stays on the server — it never goes into the page.

• Settings → Playback → Automatic playback decides what happens when the address already carries a video (#video-…): Never (the default), the visitor starts it; From a direct link only, it starts — handy for a newsletter, but since the address keeps the last video clicked, the page also restarts it on every reload. Clicking a thumbnail always plays the video, either way.
• A player and its details: channel name, title, duration, format, family values (those of the primary family highlighted), description, buttons and direct link.
• Search that ignores capitals and accents, covers title, description and family values, and keeps only videos containing every word typed.
• Filters per family, which add up: “Winter” then “Jura” keeps only videos tagged both winter and Jura. Each value shows the number of videos you will get by choosing it, given the other filters; a value that would give none is greyed out, and a family with no value in the channel does not appear. A counter shows the number of videos displayed out of the total.
• The “Channel” filter narrows down: as soon as a channel is chosen, the other channel buttons disappear — they only offered an elsewhere, and the bar grew for nothing. “All” stays, and is how you come back. Setting in Settings → Your channels, can be unticked; it never touches your tag families, where you keep hopping from one value to another.
• “All”, at the head of each family, only resets ITS family — not the others. As soon as a filter or a search is active, a Clear all button appears in the bar: that one removes everything at once, search included.
• A map of mainland France, following the Map of places setting — automatic (from two distinct places on), always (as soon as a single place can be placed) or never — when the channel's videos carry a position: one dot per value of the primary family, placed at the centre of its videos' positions and larger the more videos it has. Beside it, the list of values in columns, as many as the width allows, grouped by row if you entered any groupings — otherwise located values first, then those no position places, under “Without a place on the map”. Choosing a dot or a value filters the channel and closes the map.
• “Also worth watching”, if you picked videos in Settings → Playback → Also worth watching: your selection, in your order, the same for everyone. Each video only appears on the channel it belongs to, and never under itself.
• “More like this”, when nothing is picked: up to ten videos from the same channel and format that share values with the current video or are close by. Visitors choose the criteria — each family, and proximity — and set the radius, from 5 to 300 km. Their choices are kept for their next visit. This automatic suggestion is worth what your tags are worth: on a catalogue where every video carries the same one, it offers the whole channel, highlighting nothing.
• A floating player: on a screen wider than 900 pixels, a playing video tucks itself into the bottom right corner when the page is scrolled. The cross pauses and closes it; clicking its title brings you back to the player.
• Their progress: a bar on thumbnails already started, and ✓ Watched beyond 95 %.
• A direct link to each video, to copy under the details, and the buttons you have set.

Keeping content up to date

The Content tab gathers everything about the catalogue copy.

• Refresh the catalogue — videos, descriptions, images, tags, custom fields and positions. The time since the last refresh is shown beside it.
• Refresh the statistics — the figures of the Audience tab. Slower: one call per playlist and per period.
• Automatic refresh — Never, Once a day or Once a week, catalogue and statistics together, then Save the schedule. The first run happens about an hour later, and the next due time is shown. WordPress triggers these tasks on the first visit after the scheduled time: the exact moment is not guaranteed. If an automatic refresh fails, a warning says so at the top of this tab.

The report gives the number of videos, including reels, and those without a description, without any tag or without coordinates. Warnings flag offline videos left out, and vertical videos lacking the “reel” tag — filed among the reels all the same.

Completing video records

The Records to complete tab

It lists the videos missing something, the barest first, with their playlist and place: description, position, reel tag for a vertical video, and a value in each of its playlist's families. A summary at the top counts what is missing by kind. The title opens the record in the Streamlike back office, which requires being logged in to your account.

Search and sort.
A field above the table narrows it down to what you type — a title, a playlist, a place, or even “position” to keep only the records missing it. Accents are ignored. Click a heading to sort on it, click again to reverse. Everything happens in the page: nothing is reloaded, nothing is saved, and reloading the page puts the table back in its original order.

Review mode

On the public page, administrators see a Record review mode checkbox — in the band with [webtv], or wherever you placed [webtv_relecture]. When ticked, it:

• flags under each thumbnail what is missing (“without description”, “without season”…);
• shows it in the current video's details too;
• displays a tally band: how many records are incomplete, and why;
• shows rows that are still empty, and splits the last row in two: videos no grouping took on one side, those carrying no value at all on the other, under “Without <name of the primary family> — to be filed”. Outside review mode the two are gathered under “Other videos”: the visitor has no use for the distinction (in a mosaic there are no rows: only the thumbnails flag what is missing).

Visitors never see this checkbox. It changes nothing: it is a working view.

Tracking the audience

The Audience tab shows Streamlike figures, video by video, most watched first. Two periods: last 12 months and all time. They update with Refresh the statistics, or with the automatic refresh.

⚠️ Plays ignore the period.
Streamlike counts them since the video was created, unlike every other column. To compare two periods, rely on viewers, sessions and time watched.

Search and sort.
A field above the table narrows it down to what you type — a title, a playlist, a place, or even “position” to keep only the records missing it. Accents are ignored. Click a heading to sort on it, click again to reverse. Everything happens in the page: nothing is reloaded, nothing is saved, and reloading the page puts the table back in its original order.
The totals row follows the search: filtered on one playlist, it counts only its videos. Clear the search and the overall totals come back.

These figures are never sent to the public page.

Customising the appearance

The Appearance tab is set without writing any style. As long as you have changed nothing, the WebTV keeps its original look.

Panels and preview

Settings are arranged in panels that open with a click; on the right, a preview stays on screen while you scroll. This preview is a real WebTV in miniature — the band, the player and its details, the filter bar, a row of thumbnails — made of the same elements and the same stylesheet as the public page: what you see there is what visitors will see. It follows every setting live, without saving anything.

Click an area of the preview — a row title, a thumbnail, a filter button —: the panel that sets it opens, and the other panels that concern it are offered as buttons just above the preview. The One panel open at a time box closes the other panels when you open one; unticked, Expand all opens them all. After saving, the page reopens the panel you were working in.

In the detailed panels, a colour left empty is not a missing colour: the element keeps the one it takes from the palette (the selected button takes the main colour, for instance). The picker's Clear button returns to that behaviour.

Colours

Four choices are enough; the in-between shades — lines, secondary text, hovers — are derived from them.

Typography and shapes

• Font — the system one (recommended), the theme's one, a serif, a monospace, or another one already loaded by the theme, whose exact name you type. The plugin downloads no font.
• Text size — from 80 to 140 %, all text at once.
• Corner rounding — from 0 to 20 px, zero for sharp corners.

Spacing

Detailed panels

The thumbnails of “More like this”, on the player background, keep their own colours; their format and rounding follow the Thumbnails panel.

The band starts from the player background.
With nothing set, its colour, its text and its tab background are derived from “Player band”. As soon as you give it a background of its own, think of the tab group background: the original light pill reads poorly on a dark ground.

CSS touch-ups

For anything not covered, an editor accepts your own style rules, applied after everything else: they win. It colours the syntax, flags a missing brace, and completes what you type:

• outside a brace, the start of a hook — .swtv .ca or simply .car — offers the WebTV's style hooks with their explanation (“.swtv .carte — a clickable thumbnail”);
• inside a brace, --acc offers the variables, and col the CSS properties, then their values.

Enter or Tab accepts the suggestion, Ctrl-Space reopens the list. Prefix every selector with .swtv so you only affect the WebTV. A folded reference just below lists the available variables and style hooks; the integration guide reproduces them in full.

If you have disabled syntax highlighting in your WordPress profile (Disable syntax highlighting when editing code), the field stays a plain text field, without completion.

Restore the original appearance cancels all these choices at once.

Buttons, links and footer

Buttons under each video

In Settings → Integration → Buttons on the video details, each row creates a button: a label, and in the second column either an address or the name of a Streamlike custom field.

• An address — the button appears on every video. Placeholders in curly braces are replaced video by video: {titre} (title), {id}, {lieu} (place), and the name of each of your families, in lower case, such as {theme}. The exact list of placeholders is shown under the setting.
• The name of a custom field — the button only appears on videos whose field, in Streamlike, holds an address. The field names found in your catalogue are suggested as you type.

https://example.com/contact/?video={titre}

An empty row waits at the bottom of the list: fill it in and save, and a new free row appears. Emptying a row deletes the button. The first button is highlighted, the following ones stay quieter. A web link opens in a new tab, so the video is not interrupted.

Addresses start with https://, mailto: or tel:. If a placeholder is empty for a video — a missing tag, for instance —, the button does not appear on it. The integration guide covers the case of a pre-filled contact form.

The direct link to a video

Copy the link to this video, under the details, gives an address that opens the WebTV on that video and plays it, whatever channel it is filed under: ideal for a newsletter or a social network. When a visitor chooses a video, the page's address changes too: it can be copied straight from the address bar.

The footer

It is empty by default. Settings → Footer credit places your text there on every page, with a link, bold or italics if needed:

Filmed by <a href="https://example.com">Example Studio</a>

The texte attribute replaces it on a given page. Administrators also see the catalogue's refresh date there, with a link to refresh. A Clear my watching progress button is added for visitors who have started videos, unless historique="non" is set.

Privacy

• The API key stays on the server. It never appears in pages.
• Public pages only receive what is needed to show the videos. No statistics, no back-office link, no custom fields — except those you list in Fields sent to the page, which then become readable by anyone. A field used by a button only sends the button's address.
• Watching progress and “More like this” choices are kept in the visitor's browser (local storage), and sent nowhere. Visitors can clear their progress from the footer.
• No font is downloaded from a third-party service.
• The video player and images are provided by Streamlike. What the player records falls under Streamlike's responsibility, to be mentioned where relevant in the site's privacy policy. Streamlike's privacy policy, which covers its video platform: https://www.streamlike.eu/privacy-policy/

Frequently asked questions

The WebTV does not appear on the page

The catalogue has probably not been fetched yet: open the Content tab and refresh it. Logged in as an administrator, you will see a message where the WebTV should be; visitors see nothing. Also check that there is not already a WebTV or blocks elsewhere on the page.

I set disposition="grille" and still see rows

That is expected: grille keeps rows and their titles, and on rows of a few videos a grid looks exactly like a row. For one single big grid without rows, write disposition="mosaique". See disposition.

An attribute seems ignored

Check the quotes: they must be straight ("), not curly. Also check the value's spelling — rangees has no accent — and, for blocks, that the attribute is accepted by the block carrying it: titre on [webtv_chaines], texte and historique on [webtv_pied].

A change made in Streamlike does not show

Refresh the catalogue. Pages read the copy kept in WordPress, never Streamlike directly. If your site uses a caching plugin, clear its cache too.

A video is missing

Check that it is online in Streamlike, that it belongs to one of the playlists set, and that the catalogue has been refreshed since. The Content tab's report flags offline videos left out. On a page set with playlist, only that playlist's videos are present. Think of the format too: a vertical video is under Reels, not Films.

A video disappears as soon as I filter, or a value is greyed out

Filters are strict: a video stays on screen only if it carries all the chosen values. A video without any season tag therefore disappears under “Winter” as under “Summer”, and a greyed-out value — “Jura (0)” — means no video combines that value with the filters already chosen. The title does not count: a video called “… of the Jura” without the JURA tag is not a Jura video for the WebTV. Complete its tags in Streamlike; the Records to complete tab lists the videos concerned.

The channel band shows nothing

Tabs only appear when there are at least two channels to choose from. Three settings remove them, all deliberately:

• Settings → Sorting and filters → Several playlists → All together: the playlists are gathered into a single view, and are picked from the filter bar, under Channel. That is the portfolio case;
• a single playlist ticked in the settings;
• the playlist attribute on a block, which devotes the page to one channel.

With no tabs and no title, the band has nothing left to show: it erases itself, and the [webtv_chaines] block placed on its own gives nothing. In that case, add a header title, switch the setting to tabs, or remove the block — the channel choice then lives in the filters. The editor's mock-up now tells you so, with the reason.

The left side of the band stays empty

You picked Appearance → Band and channels → Placement of the title and tabs → Title on the left, tabs on the right (or centred), and the left half is empty. That is because there is no title: it does not come from the settings but from the brick's titre attribute — the Header title field in the block's sidebar, or [webtv_chaines titre="My WebTV"]. Fill it in, or go back to Tabs following the title, which leaves no gap. The editor's mock-up points this out.

A filter or the map has disappeared

This is deliberate when they would have nothing to show: a family with no value in the channel on display is not shown, and the Map button disappears when no video of the channel carries a position — or when the [webtv_carte] block is not on the page.

A dot is missing on the map

Which tags are places. Under the three choices above, tick boxes: the tags carried by at least one located video, arranged by channel — a place almost always belongs to a single playlist, and an alphabetical list of twenty mixed tags gets ticked blindly. A tag carried by several channels goes in a group of its own. Each channel has its tick / untick shortcuts, and the whole area its Tick all / Untick all. With none ticked, the map places every value of the primary family — on a catalogue where that family takes every tag, “Documentary” and “Summer” end up on it too, at the centre of gravity of their videos, next to Cantal. Tick your place tags and the map shows only those, dots and the list beside it. The rest of the WebTV does not move: those tags stay filters and rows as before.

The map places one dot per value of the primary family, from its videos' positions. A value none of whose videos has a position stays in the list beside the map, without a dot. A position outside mainland France does not appear on the map.

A button does not appear under a video

That video's custom field is empty, its address does not start with https://, mailto: or tel:, or one of the address's placeholders is empty for it. After a change in Streamlike, remember to refresh the catalogue.

The WebTV looks narrow

It is then following the theme's width: check that the largeur="contenu" attribute is not set. Blocks default to contenu: add largeur="pleine" to those that must take the whole window, or widen the builder section containing them.

In my builder, I see a mock-up instead of the WebTV

That is deliberate: a builder's editor cannot run the WebTV. The mock-up shows each block's position, size and settings; the published page shows the real WebTV. If your builder still shows empty, unstyled blocks, it was not recognised: a developer can add it in one line, see the integration guide.

The refresh stops midway

On an account with a great many playlists, or at a host that strictly limits processing time, the refresh may exceed the time allowed. Try again outside busy hours, or ask your host to extend that limit.

Asking for help: the diagnostic report

At the very bottom of Settings, a Help and diagnostics box holds a ready-made report: plugin version, licence state, WordPress, theme, page builder, cache, server, catalogue state and your display settings. Copy it and attach it to your message when you ask for help: it saves three round trips.

It contains none of your keys. Neither the Streamlike API key nor the licence key: it only says whether they are filled in. It holds no watching history either. It is in plain text — read it through if you wish.

Licence and updates

The plugin does not live in the WordPress directory: it is sold separately. So it is the author's site that announces new versions, and your licence key that opens that service. Paste it in Settings → Licence and updates → Licence key.

After that, nothing to do: WordPress will offer this plugin's updates like any other plugin's — the badge on the Plugins menu, the Update now button, the View details link.

The server's answer is kept for six hours, so as not to call it on every admin page. The screen therefore says how old what it shows is — “checked 2 hours ago” — and the Check now button asks again right away. That is what to do after entering a key, or if your subscription has just changed.

Check again, on WordPress's Dashboard → Updates screen, also forces a real request: a version published moments ago is therefore offered without waiting.

An expired licence never closes the WebTV. It stops updates, nothing else: your pages keep showing, your settings stay, so does your catalogue.

This key has nothing to do with your Streamlike API key: one receives the plugin's updates, the other fetches your videos.

Uninstalling the plugin

Deactivating then deleting the plugin keeps your settings and catalogue by default, so you can reinstall without losing anything. To erase everything, first tick Settings → Maintenance → Erase settings and catalogue if the plugin is deleted, save, then delete the plugin. Nothing is ever changed in your Streamlike account.

WebTV for Streamlike · WordPress 6.4 and PHP 7.4 minimum · guide written for version 1.29.0

Sommaire

1. Avant de commencer
2. Installer et relier le site à Streamlike
3. Préparer ses vidéos dans Streamlike
4. Organiser : familles de tags et rangées
5. Poser la WebTV dans une page
6. Régler la WebTV : les attributs
7. Composer la page avec les briques
8. Ce qui ne se combine pas
9. Ce que voit le visiteur
10. Garder le contenu à jour
11. Compléter les fiches
12. Suivre l'audience
13. Personnaliser l'apparence
14. Boutons, liens et pied de page
15. Confidentialité
16. Questions fréquentes

Avant de commencer

Il vous faut :

• WordPress 6.4 ou plus récent, avec PHP 7.4 ou plus récent ;
• un compte Streamlike et une clé d'API de ce compte ;
• vos vidéos rangées dans une ou plusieurs playlists Streamlike : chaque playlist devient une chaîne de la WebTV.

L'extension fonctionne avec n'importe quel thème et avec les constructeurs de pages comme Oxygen ou Elementor.

Un principe à retenir.
Vos pages ne contactent jamais Streamlike. L'extension récupère le catalogue depuis l'administration et le garde dans WordPress ; les visiteurs lisent cette copie. Une modification faite dans Streamlike n'apparaît donc sur le site qu'après une actualisation — à la main, ou automatiquement.

Installer et relier le site à Streamlike

Installer l'extension

1. Dans WordPress, ouvrez Extensions → Ajouter une extension → Téléverser une extension.
2. Choisissez le fichier webtv-for-streamlike-1.30.0.zip — celui qui porte le numéro de version, pas l'archive de livraison qui le contient —, puis Installer maintenant.
3. Cliquez sur Activer. Un menu WebTV for Streamlike apparaît dans la colonne de gauche.

L'administration de l'extension compte cinq onglets : Réglages, Contenu, Apparence, Fiches à compléter et Audience. Seuls les administrateurs du site y ont accès.

Dans Réglages comme dans Apparence, les rubriques sont rangées en volets qui se déplient d'un clic — Accès à Streamlike, Vos chaînes, Classement et filtres, Lecture, Pied de page, Intégration, Licence et mises à jour, Entretien. La case Un seul volet ouvert à la fois referme les autres quand vous en ouvrez un ; décochée, Tout déplier les ouvre tous. Le volet où vous travailliez se rouvre après un enregistrement.

Relier le site à Streamlike

Dans WebTV for Streamlike → Réglages, section Accès à Streamlike :

1. Clé d'API — créez-la dans le back-office Streamlike, menu de votre avatar → Clés d'API/FTP, de type « api », et collez-la ici. Une fois enregistrée, elle n'est plus jamais réaffichée en clair : seuls ses quatre derniers caractères restent visibles. Laisser le champ vide conserve la clé actuelle. Elle ne sert qu'au serveur et n'est jamais envoyée au navigateur des visiteurs.
2. Cliquez sur Enregistrer. La liste de votre compte Streamlike s'affiche alors d'elle-même, avec le nom de chaque playlist, son nombre de vidéos et sa durée.
3. Cochez les playlists qui deviendront les chaînes de la WebTV, puis Enregistrez à nouveau. Les vidéos des chaînes cochées sont récupérées dans la foulée : le message vous dit combien.

C'est tout : clé, cases, enregistrer. Deux boutons restent là pour les cas particuliers — Rafraîchir la liste, après avoir créé une playlist dans Streamlike, et Contenu → Actualiser le catalogue, après avoir modifié des vidéos.

Plusieurs playlists cochées : ensemble ou en onglets ? Le réglage juste en dessous décide.

• Tout ensemble — une seule vue réunit toutes les vidéos, avec un filtre Chaîne pour n'en garder qu'une. C'est le choix d'un portfolio, et celui de la formule Portfolio.
• En onglets — un onglet par playlist, chacun ne montrant que ses vidéos. C'est le choix de deux marques sur un même site.

En onglets, l'ordre de la liste est celui des onglets, et la première playlist cochée est celle qui s'ouvre à l'arrivée sur la page. Avec une seule playlist cochée, ce réglage ne change rien.

Une playlist sans aucune vidéo n'est pas proposée à cocher : elle est simplement rappelée sous la liste, pour que vous fassiez le ménage dans Streamlike si vous le souhaitez.

Mettre la liste à jour la relit chez Streamlike : une playlist créée depuis apparaît alors, sans que vos cases changent. Une playlist cochée qui a disparu du compte reste affichée, signalée « Pas dans la liste récupérée », pour que vous la décochiez en connaissance de cause.

⚠️ Après avoir coché une nouvelle playlist, actualisez le catalogue.
Tant que ses vidéos n'ont pas été récupérées, la chaîne s'affiche vide sur le site. L'extension vous le signale : un avertissement en haut de son administration, et un message sur la page, visible des seuls administrateurs.

Seules les playlists cochées existent pour la WebTV.
Une playlist non cochée n'est pas récupérée : un code court qui la demanderait resterait vide.

Préparer ses vidéos dans Streamlike

La WebTV montre ce que vos fiches Streamlike contiennent. Mieux elles sont remplies, plus la chaîne est riche.

Après chaque série de modifications dans Streamlike, actualisez le catalogue.

Organiser : familles de tags et rangées

Choisir une formule

Avant tout réglage fin, Réglages → Classement et filtres propose quatre formules. Elle décide de la façon dont vos vidéos sont rangées et de ce qu'on propose au visiteur pour s'y retrouver.

Un repère vous dit ce que la formule trouvera : « Votre catalogue porte 16 tags, dont 5 sur au moins trois vidéos ».

Changer de formule ne détruit rien : vos familles construites à la main restent enregistrées, et « Sur mesure » les retrouve telles quelles. Une installation existante garde exactement ce qu'elle affichait.

Les familles de tags (réglage avancé)

Utilisées par la seule formule « Sur mesure ». Une famille dit ce qu'un groupe de tags devient sur la WebTV : un filtre, avec son nom et sa présentation. Elles se règlent dans Réglages → Familles de tags, à l'aide d'une carte par famille :

• Nom affiché — ce que lit le visiteur : « Destination », « Logiciel », « Thème »…
• Présentation — une liste déroulante, pratique pour de nombreuses valeurs, ou des boutons avec le nombre de vidéos, pour quelques valeurs ;
• Tags rassemblés — **« Tout le reste (\*) », qui prend tous les tags qu'aucune autre famille ne réclame, y compris ceux ajoutés plus tard ; ou des tags choisis un par un**, proposés en cases à cocher d'après votre catalogue, avec le nombre de vidéos de chacun ;
• Sur quelles playlists — pour réserver une famille à certaines chaînes. Un portfolio et un catalogue de séjours n'ont pas le même vocabulaire : chaque onglet n'affiche que les familles qui le concernent. Aucune case cochée : la famille vaut partout.

Le bouton Ajouter une famille crée une nouvelle carte ; la croix en supprime une. Les tags proposés sont ceux du dernier catalogue récupéré : après avoir ajouté des tags dans Streamlike, actualisez le catalogue pour les voir apparaître ici.

Le constructeur reste replié tant qu'une formule toute faite est choisie.
Sous « Portfolio », « Chaîne thématique » ou « Voyages et lieux », il n'aurait aucun effet : à sa place, une ligne rappelle ce qui reste enregistré, et un lien Voir mes familles quand même l'ouvre pour consultation. Il s'ouvre de lui-même dès que vous choisissez « Sur mesure ».

Aucune famille est un réglage valable : la WebTV montre alors toutes les vidéos dans une seule mosaïque, sans aucun filtre — et c'est bien ce qui est enregistré. Un bouton Installer l'exemple « Destination / Saison » remet les deux familles d'origine en un clic.

La première famille est la principale.
C'est elle, marquée Principale, qui découpe la chaîne en rangées et qui place les points sur la carte. Les suivantes ne font que filtrer. Réordonnez les familles avec les flèches ↑ ↓.

La principale se lit chaîne par chaîne : c'est la première famille qui concerne la playlist affichée. Si « Client » est réservée à une chaîne et « Thème » à l'autre, chacune est la principale de la sienne.

Un lien Modifier sous forme de texte donne accès au même réglage en lignes de texte, pour qui préfère coller une liste : une famille par ligne, avec le nom, liste ou boutons, les tags (ou *), et facultativement les identifiants de playlists, séparés par des barres verticales.

Destination | liste | *
Saison | boutons | printemps, été, automne, hiver
Logiciel | boutons | Photoshop, Final Cut Pro | 0f1e2d3c4b5a6978

L'ordre des vidéos

Réglages → Classement et filtres → Ordre des vidéos décide de l'ordre partout : dans chaque rangée, dans la mosaïque, dans la grille et dans les propositions sous le lecteur.

⚠️ L'ordre de votre playlist ne remonte pas toujours de Streamlike.
L'API donne une « position » par vidéo, mais elle vaut souvent le même nombre pour toutes les vidéos d'une playlist — mesuré le 27 septembre 2026. Le classement revient alors au titre, sans que rien ne le dise. Si votre ordre manuel compte, choisissez explicitement l'un des autres classements.

Les deux classements par date et par lectures demandent une actualisation du catalogue : c'est elle qui va chercher ces deux informations chez Streamlike.

Laisser le visiteur trier

Réglages → Classement et filtres → Tri proposé au visiteur ajoute un menu Trier sur la page : aucun (par défaut), en haut de la page, ou en haut de la page et sur chaque rangée. Vous cochez ensuite les tris proposés — titre, plus récentes, plus vues, au hasard ; le visiteur retrouve toujours « Ordre du site » en tête de liste pour revenir à votre classement.

Avec le troisième choix, chaque rangée porte son propre menu : on peut demander « les plus récentes » sur une rangée et laisser les autres tranquilles. Un choix fait en haut de la page remet toutes les rangées d'accord avec lui.

Ce qui part dans la page. Le tri se fait dans le navigateur : la date de mise en ligne y voyage telle quelle, et pour « les plus vues », seulement un rang, jamais le nombre de lectures. Proposer ce tri revient à publier cet ordre — c'est le sens du réglage —, mais les compteurs, eux, restent sur le serveur.

Les rangées

Par défaut, chaque valeur de la famille principale forme sa propre rangée, par ordre alphabétique : une rangée par valeur. Les vidéos qui n'ont aucune valeur dans cette famille se retrouvent dans une dernière rangée, Autres vidéos.

Pour réunir plusieurs valeurs sous un même titre, allez dans Réglages → Regroupements de rangées. Le bouton Ajouter un regroupement crée une carte : un titre de rangée, puis les valeurs à y réunir, en cases à cocher d'après votre catalogue, avec le nombre de vidéos de chacune. Les flèches ↑ ↓ ordonnent les rangées, la croix en supprime une. Une valeur déjà prise par une autre rangée reste proposée, en grisé : elle apparaîtra alors dans les deux.

Un lien Modifier sous forme de texte donne le même réglage en lignes, pour qui préfère coller une liste — une rangée par ligne, au format « titre | valeur, valeur… » :

Alpes du Nord | Vercors, Chartreuse Belledonne, Pays du Mont Blanc – Val d'Arly
Pyrénées | Pays Basque, Hautes-Pyrénées

Majuscules, accents et types de tirets n'ont pas d'importance. Les rangées suivent l'ordre que vous leur donnez. Une valeur mal orthographiée est ignorée ; si aucune ne correspond, l'extension revient au découpage automatique.

Quand elle est la seule rangée de la page, elle porte le nom de ce qu'on a demandé — la valeur filtrée, ou la recherche : « Autres vidéos » ne veut plus rien dire quand il n'y a pas d'autres.

Rien ne se perd, et rien n'apparaît deux fois. Une vidéo qu'aucun regroupement n'a prise rejoint une dernière rangée Autres vidéos, avec celles qui ne portent aucune valeur. Une vidéo déjà rangée n'y figure pas : cette rangée recueille des vidéos non rangées, pas des valeurs oubliées. Si elle est grosse, c'est qu'il reste des valeurs à citer — sur une chaîne entière, souvent. Avec des regroupements saisis, la liste déroulante de la famille principale regroupe aussi ses valeurs sous le nom de chaque rangée.

⚠️ Les regroupements valent pour toutes les chaînes.
Sur un site à plusieurs chaînes, un regroupement qui ne cite que les valeurs de l'une laisse toutes les vidéos de l'autre dans « Autres vidéos ». Pour lui donner ses rangées, citez aussi ses valeurs, par exemple Sport | Sport et Tutoriels | Tuto. Ou laissez les regroupements vides : chaque valeur forme alors sa propre rangée, partout.

Les Reels ne sont jamais découpés en rangées : ils s'affichent tous ensemble, dans une grille verticale. Et pour une petite playlist, où les rangées ne compteraient qu'une ou deux vidéos, préférez une seule grande grille : disposition="mosaique".

Poser la WebTV dans une page

Créez ou ouvrez une page. Deux façons de poser la WebTV, au choix :

• dans l'éditeur de WordPress, ajoutez le bloc WebTV complète : tapez /webtv pour le trouver tout de suite, ou cherchez la rubrique WebTV for Streamlike de l'inséreur ;
• partout ailleurs — Oxygen, Bricks, Divi, Elementor, un widget, un modèle de thème —, écrivez le code court :

[webtv]

L'élément s'appelle Shortcode dans Oxygen, Code court dans Elementor et dans le bloc du même nom de WordPress. Les deux chemins font exactement la même chose. La page publiée affiche la WebTV entière, sur toute la largeur de la fenêtre, dans cet ordre :

1. le bandeau : le titre, s'il y en a un, les onglets de chaîne et, pour les administrateurs, la case du mode relecture ;
2. le lecteur et la fiche de la vidéo ;
3. « Dans la même veine » ;
4. la barre des filtres, en trois groupes qui passent à la ligne d'un bloc quand la place manque : ce qu'on regarde (Films ou Reels, recherche), ce qu'on filtre (familles de tags, Tout effacer), et la fin de ligne (Trier, Carte, compteur) ;
5. le panneau de la carte, fermé tant qu'on ne l'ouvre pas ;
6. les rangées de vignettes ;
7. le pied de page.

Pour disposer ces morceaux autrement — le lecteur dans une colonne, la carte dans une autre section —, voyez les briques.

Une seule WebTV par page.
Un second [webtv], ou un [webtv] ajouté à une page qui contient déjà des briques, n'est pas affiché. Connecté en administrateur, vous voyez à sa place un message qui l'explique ; les visiteurs ne voient rien.

Régler la WebTV : les attributs

Un code court accepte des attributs, écrits après son nom, chacun suivi du signe égal et d'une valeur entre guillemets droits. L'ordre n'a pas d'importance, et on peut en combiner plusieurs :

[webtv playlist="a1b2c3d4e5f60718" titre="Notre chaîne vidéo" largeur="contenu"]

Des guillemets droits.
Écrivez " et non “ ”. Certains éditeurs remplacent les guillemets à la frappe : un attribut entre guillemets typographiques est ignoré, et la WebTV reprend son réglage par défaut.

Dans l'éditeur de WordPress, ces réglages sont dans le panneau de droite.
Rien à écrire, aucun guillemet à surveiller, et la liste de vos vraies chaînes s'affiche au lieu de leur identifiant. Voir Composer la page avec les briques.

playlist — une page par chaîne

[webtv playlist="a1b2c3d4e5f60718"]

La page n'affiche que les vidéos de cette playlist. Les onglets de chaîne disparaissent d'eux-mêmes, puisqu'ils n'offriraient aucun choix, et seules les familles de tags de cette chaîne sont proposées.

• L'identifiant doit figurer dans Réglages → Playlists, coché. Sinon la WebTV reste vide, et un message le dit aux administrateurs — en nommant la playlist demandée. C'est le piège classique quand on change de chaîne sans toucher aux pages : décocher une playlist ne modifie pas les codes courts qui la nomment.
• Un lien direct vers une vidéo d'une autre playlist ne fonctionne pas sur cette page : la vidéo n'y est pas.
• Le reste — familles, regroupements, apparence, boutons — reste réglé une fois pour tout le site.

titre — le nom dans le bandeau

[webtv titre="Notre chaîne vidéo"]

Le texte s'affiche à gauche des onglets de chaîne. Sans titre, sur une page consacrée à une seule playlist, le bandeau entier disparaît pour les visiteurs : il n'aurait plus rien à montrer.

disposition — rangées, grille ou mosaïque

Deux questions distinctes : les vidéos sont-elles regroupées en rangées titrées, et les vignettes d'un groupe défilent-elles ou passent-elles à la ligne ?

Dans les rangées et la grille, les groupes sont les valeurs de la famille principale, ou vos regroupements.

Quand utiliser quoi.

• mosaique — les petites playlists, où des rangées d'une ou deux vidéos morcelleraient la page ; un portfolio ; toute chaîne où le classement par thème n'apporte rien à l'œil. Les filtres, la recherche et la carte continuent de fonctionner : ils réduisent simplement la mosaïque.
• grille — de longues rangées que vous voulez montrer en entier, sans défilement horizontal, en gardant leurs titres.
• rangees — une page compacte, qui défile même au-delà de douze vidéos par groupe.
• auto — ne rien décider : convient à la plupart des catalogues classés.

⚠️ grille ne supprime pas les rangées.
Sur des groupes courts — moins de vignettes qu'il n'en tient dans la largeur de l'écran, trois ou quatre sur un ordinateur —, une rangée qui défile et une grille sont identiques : rien ne déborde. Pour une page sans rangées, c'est mosaique.

Aucune disposition n'agit sur les Reels, toujours présentés en une grille verticale. L'accent est toléré : mosaïque fonctionne aussi.

largeur — toute la fenêtre ou la largeur du thème

[webtv] est en pleine par défaut ; les briques sont en contenu. Choisissez contenu quand la WebTV partage la page avec une colonne latérale, ou dans une section de constructeur dont vous réglez vous-même la largeur.

texte — la mention du pied de page, pour cette page

[webtv texte="Tournages : Studio Exemple, 2026"]

Remplace, sur cette page seulement, la mention réglée dans Réglages → Mention du pied de page. Un attribut ne peut pas contenir de lien : ses guillemets fermeraient l'attribut. Pour un lien, le plus sûr est le réglage général. On peut aussi encadrer le texte :

[webtv]Tournages : <a href="https://exemple.fr">Studio Exemple</a>[/webtv]

⚠️ Oxygen abîme le texte encadré.
Constaté sous Oxygen : le texte placé entre [webtv] et [/webtv] n'arrive pas intact. Avec ce constructeur, passez par le réglage Mention du pied de page.

historique — le bouton d'effacement

[webtv historique="non"]

Par défaut, un visiteur qui a commencé des vidéos voit dans le pied de page le bouton Effacer ma progression de visionnage. non le retire. La progression reste enregistrée dans son navigateur ; il ne peut simplement plus l'effacer depuis la page.

Composer la page avec les briques

La WebTV existe aussi en huit briques, une par morceau, à placer où vous voulez dans la page : le lecteur en haut à gauche, les filtres dans une colonne, la carte dans une section plus bas. Elles forment ensemble une seule WebTV : elles se retrouvent et se répondent, même éloignées l'une de l'autre.

Trois attributs se posent sur n'importe quelle brique :

• playlist et disposition valent pour toute la page. Mettez-les une fois, sur la brique de votre choix — sur [webtv_chaines] par exemple ;
• largeur se règle brique par brique, en contenu par défaut. Ajoutez largeur="pleine" à une brique qui doit occuper toute la fenêtre.

Dans l'éditeur de WordPress : les blocs

Les neuf briques — la WebTV entière et ses huit morceaux — sont aussi des blocs de l'éditeur de WordPress, réunis dans leur propre rubrique WebTV for Streamlike de l'inséreur. Tapez / suivi du nom de la brique, par exemple /carte, pour aller plus vite.

Une fois le bloc posé, ses réglages sont dans le panneau de droite : la liste de vos vraies chaînes, la disposition, la largeur, la mention du pied de page. Plus d'identifiant de playlist à recopier.

Un bloc auquel vous ne touchez pas suit vos réglages.
Chaque réglage du panneau commence à « Comme les réglages du site », ou « Par défaut : … » pour la largeur. Tant que vous n'y touchez pas, la brique se comporte exactement comme le code court nu, et une modification faite plus tard dans les réglages se voit aussitôt sur la page. Ne renseignez que ce que vous voulez faire différemment ici.

Les règles restent les mêmes : une seule WebTV par page, chaque brique une seule fois, et les briques ne se mélangent pas au bloc WebTV complète.

Partir d'une composition

L'onglet Compositions de l'inséreur propose trois pages toutes faites, dans la rubrique WebTV for Streamlike :

Une composition posée n'est plus qu'une suite de blocs ordinaires : retirez, ajoutez, déplacez ce que vous voulez. Rien ne vous ramènera au modèle.

Un exemple de page composée

Dans un constructeur, trois sections :

Section 1, pleine largeur : [webtv_chaines titre="Nos vidéos" playlist="a1b2c3d4e5f60718"]
Section 2, deux colonnes :  [webtv_lecteur]  à gauche,  [webtv_veine]  à droite
Section 3 :                 [webtv_filtres] [webtv_carte] [webtv_rangees] [webtv_pied]

Placez [webtv_carte] près de [webtv_filtres] : c'est là que se trouve le bouton qui l'ouvre. Quand une action fait changer une brique éloignée — choisir une vignette tout en bas de la page, par exemple —, la WebTV fait défiler la page jusqu'à elle.

Dans l'éditeur : la maquette

Un constructeur ne fait pas tourner la WebTV dans son éditeur : il n'y charge ni sa mise en forme ni son script. Chaque brique y affiche donc une maquette : un dessin simplifié, à peu près à sa taille réelle et dans vos couleurs, qui porte le nom de la brique, son code court et les attributs qui changent quelque chose (playlist, disposition, largeur, titre…). De quoi composer la page en voyant les volumes. La vraie WebTV s'affiche sur la page publiée, ou dans l'aperçu du site.

La maquette apparaît dans l'éditeur de WordPress — c'est ce que montrent les blocs —, dans Oxygen, Elementor, Bricks, Beaver Builder et Divi, et en principe dans tout constructeur qui prépare ses aperçus en arrière-plan. Elle n'est montrée qu'aux personnes qui peuvent modifier des pages : un visiteur ne la voit jamais. Le bloc Code court, lui, n'affiche que le texte du code court.

Les règles des briques

• Chaque brique ne figure qu'une fois par page. Une brique en double n'est pas affichée ; un administrateur voit un message à sa place.
• Briques et [webtv] ne se mélangent pas sur une même page : c'est l'un ou l'autre.
• Une brique absente rend sa fonction inerte, sans rien casser. Sans [webtv_carte], le bouton Carte disparaît. Sans [webtv_pied], pas de mention.
• Les briques héritent de l'apparence réglée dans l'onglet Apparence, où qu'elles soient.

Les briques qui dépendent l'une de l'autre

Certaines briques n'ont de sens qu'accompagnées. Rien ne se casse sans elles, mais une partie de la WebTV devient inaccessible :

Ce qui ne se combine pas

Les limites à connaître, rassemblées au même endroit.

Ce que voit le visiteur

• Des onglets de chaîne, un par playlist, et deux formats : Films et Reels, avec leur nombre de vidéos. Un format vide dans une chaîne est grisé. À l'arrivée, une vidéo est chargée dans le lecteur, sans démarrer : laquelle se règle dans Réglages → Lecture → Vidéo d'ouverture.
• Réglages → Lecture → Vidéo d'ouverture décide de celle qui est posée dans le lecteur à l'arrivée : la première de la playlist (l'ordre de Streamlike, le comportement d'origine), la première de votre sélection « À voir aussi », la plus récemment mise en ligne, la plus vue, ou une au hasard à chaque visite. Le choix vaut chaîne par chaîne et format par format : chaque onglet ouvre sur sa propre vidéo, et les Reels sur la leur.

> Les deux classements plus récente et plus vue viennent de Streamlike : après les avoir choisis, actualisez le catalogue pour que la date et le compteur soient récupérés. Le nombre de lectures reste sur le serveur — il ne part jamais dans la page.

• Réglages → Lecture → Lecture automatique décide de ce qui se passe quand l'adresse porte déjà une vidéo (#video-…) : Jamais (par défaut), le visiteur lance lui-même ; Depuis un lien direct seulement, elle démarre — pratique pour une lettre d'information, mais l'adresse gardant la dernière vidéo cliquée, la page redémarre aussi à chaque rechargement. Un clic sur une vignette lance toujours la vidéo, dans les deux cas.
• Un lecteur et sa fiche : nom de la chaîne, titre, durée, format, valeurs des familles (celles de la famille principale en évidence), description, boutons et lien direct.
• Une recherche qui ignore majuscules et accents, porte sur le titre, la description et les valeurs des familles, et ne garde que les vidéos contenant tous les mots tapés.
• Des filtres par famille, qui se cumulent : « Hiver » puis « Jura » ne garde que les vidéos taguées à la fois hiver et Jura. Chaque valeur affiche le nombre de vidéos qu'on obtiendra en la choisissant, compte tenu des autres filtres ; une valeur qui n'en donnerait aucune est grisée, et une famille sans aucune valeur dans la chaîne n'apparaît pas. Un compteur indique le nombre de vidéos affichées sur le total.
• Le filtre « Chaîne » se concentre : dès qu'une chaîne est choisie, les autres boutons de chaîne disparaissent — ils n'offraient qu'un ailleurs, et la barre s'allongeait pour rien. « Toutes » reste affiché, c'est par lui qu'on revient. Réglage Réglages → Vos chaînes, décochable ; il ne touche jamais vos familles de tags, où l'on passe son temps à sauter d'une valeur à l'autre.
• « Toutes », en tête de chaque famille, ne remet à zéro que SA famille — pas les autres. Dès qu'un filtre ou une recherche est actif, un bouton Tout effacer apparaît dans la barre : celui-là enlève tout d'un coup, recherche comprise.
• Une carte de France métropolitaine, selon le réglage Carte des lieux — automatique (à partir de deux lieux distincts), toujours (dès qu'un seul lieu peut être placé) ou jamais — quand des vidéos de la chaîne portent une position : un point par valeur de la famille principale, placé au centre des positions de ses vidéos et d'autant plus gros qu'elles sont nombreuses. À côté, la liste des valeurs en colonnes, autant que la largeur en permet, groupées par rangée si vous avez saisi des regroupements — sinon les valeurs situées d'abord, puis celles qu'aucune position ne place, sous « Sans lieu sur la carte ». Choisir un point ou une valeur filtre la chaîne et referme la carte.
• « À voir aussi », si vous avez choisi des vidéos dans Réglages → Lecture → À voir aussi : votre sélection, dans votre ordre, la même pour tout le monde. Chaque vidéo n'apparaît que sur la chaîne à laquelle elle appartient, et jamais sous elle-même.
• « Dans la même veine », à défaut de sélection : jusqu'à dix vidéos de la même chaîne et du même format, qui partagent des valeurs avec la vidéo en cours ou se trouvent à proximité. Le visiteur choisit les critères — chaque famille, et la proximité — et règle le rayon, de 5 à 300 km. Ses choix sont gardés pour sa prochaine visite. Cette proposition automatique vaut ce que valent vos tags : sur un catalogue où toutes les vidéos portent le même, elle propose tout le reste de la chaîne, sans rien mettre en avant.
• Un lecteur flottant : sur un écran de plus de 900 pixels de large, une vidéo en lecture se loge en bas à droite quand on fait défiler la page. La croix la met en pause et la referme ; cliquer sur son titre ramène au lecteur.
• Sa progression : une barre sur les vignettes déjà commencées, et la mention ✓ Vu au-delà de 95 %.
• Un lien direct vers chaque vidéo, à copier sous la fiche, et les boutons que vous avez réglés.

Garder le contenu à jour

L'onglet Contenu regroupe tout ce qui touche à la copie du catalogue.

• Actualiser le catalogue — vidéos, descriptions, images, tags, champs personnalisés et positions. Le temps écoulé depuis la dernière actualisation est affiché à côté.
• Actualiser les statistiques — les chiffres de l'onglet Audience. Plus long : un appel par playlist et par période.
• Actualisation automatique — Jamais, Une fois par jour ou Une fois par semaine, catalogue et statistiques ensemble, puis Enregistrer le rythme. La première a lieu environ une heure plus tard, et l'échéance suivante est affichée. WordPress déclenche ces tâches à la première visite qui suit l'heure prévue : le moment exact n'est pas garanti. Si une actualisation automatique échoue, un avertissement l'indique en haut de cet onglet.

Le compte rendu donne le nombre de vidéos, dont les reels, et celles sans description, sans aucun tag ou sans coordonnées. Les alertes signalent les vidéos hors ligne écartées, et les vidéos verticales qui n'ont pas le tag « reel » — rangées quand même parmi les reels.

Compléter les fiches

L'onglet Fiches à compléter

Il liste les vidéos auxquelles il manque quelque chose, les plus dégarnies d'abord, avec leur playlist et leur lieu : description, position, tag reel pour une vidéo verticale, et une valeur dans chacune des familles de sa playlist. Un résumé en tête compte les manques par sorte. Le titre ouvre la fiche dans le back-office Streamlike, qui demande d'être connecté à votre compte.

Chercher et trier.
Un champ au-dessus du tableau le réduit à ce que vous tapez — un titre, une playlist, un lieu, ou même « position » pour ne garder que les fiches où elle manque. Les accents sont ignorés. Cliquez sur un en-tête pour trier dessus, cliquez encore pour inverser. Tout se passe dans la page : rien n'est rechargé, rien n'est enregistré, et recharger la page remet le tableau dans son ordre d'origine.

Le mode relecture

Sur la page publique, les administrateurs voient une case Mode relecture des fiches — dans le bandeau avec [webtv], ou là où vous avez posé [webtv_relecture]. Cochée, elle :

• signale sous chaque vignette ce qui manque (« sans description », « sans saison »…) ;
• l'indique aussi dans la fiche de la vidéo en cours ;
• affiche un bandeau de décompte : combien de fiches sont incomplètes, et pourquoi ;
• montre les rangées encore vides, et sépare la dernière rangée en deux : les vidéos qu'aucun regroupement n'a prises d'un côté, celles qui ne portent aucune valeur de l'autre, sous « Sans <nom de la famille principale> — à classer ». Hors relecture, les deux sont réunies sous « Autres vidéos » : le visiteur n'a que faire de la nuance. En mosaïque, il n'y a pas de rangées — seules les vignettes signalent les manques.

Les visiteurs ne voient jamais cette case. Elle ne modifie rien : c'est une vue de travail.

Suivre l'audience

L'onglet Audience présente les chiffres Streamlike, vidéo par vidéo, les plus regardées en tête. Deux périodes : les 12 derniers mois et depuis toujours. Ils se mettent à jour avec Actualiser les statistiques, ou avec l'actualisation automatique.

⚠️ Les lectures ignorent la période.
Streamlike les compte depuis la création de la vidéo, contrairement à toutes les autres colonnes. Pour comparer deux périodes, fiez-vous aux spectateurs, aux visionnages et au temps vu.

Chercher et trier.
Un champ au-dessus du tableau le réduit à ce que vous tapez — un titre, une playlist, un lieu, ou même « position » pour ne garder que les fiches où elle manque. Les accents sont ignorés. Cliquez sur un en-tête pour trier dessus, cliquez encore pour inverser. Tout se passe dans la page : rien n'est rechargé, rien n'est enregistré, et recharger la page remet le tableau dans son ordre d'origine.
Le total en bas du tableau suit la recherche : filtré sur une playlist, il ne compte que ses vidéos. Effacez la recherche et le total d'ensemble revient.

Ces chiffres ne sont jamais envoyés à la page publique.

Personnaliser l'apparence

L'onglet Apparence se règle sans écrire de style. Tant que vous n'avez rien modifié, la WebTV garde son apparence d'origine.

Les volets et l'aperçu

Les réglages sont rangés en volets qui se déplient d'un clic ; à droite, un aperçu reste à l'écran pendant que vous faites défiler. Cet aperçu est une vraie WebTV en miniature — le bandeau, le lecteur et sa fiche, la barre des filtres, une rangée de vignettes — faite des mêmes éléments et de la même feuille de style que la page publique : ce que vous y voyez est ce que verront les visiteurs. Il suit chaque réglage en direct, sans rien enregistrer.

Cliquez une zone de l'aperçu — un titre de rangée, une vignette, un bouton de filtre — : le volet qui la règle s'ouvre, et les autres volets qui la concernent sont proposés en boutons juste au-dessus de l'aperçu. La case Un seul volet ouvert à la fois referme les autres volets quand vous en ouvrez un ; décochée, Tout déplier les ouvre tous. Après un enregistrement, la page rouvre le volet où vous travailliez.

Dans les volets détaillés, une couleur laissée vide n'est pas une couleur manquante : l'élément garde celle qu'il tient de la palette (le bouton choisi prend la couleur principale, par exemple). Le bouton Effacer du sélecteur revient à ce comportement.

Couleurs

Quatre choix suffisent ; les nuances intermédiaires — traits, textes secondaires, survols — en sont déduites.

Typographie et formes

• Police — celle du système (recommandé), celle du thème, une police à empattements, à chasse fixe, ou une autre, déjà chargée par le thème, dont vous tapez le nom exact. Aucune police n'est téléchargée par l'extension.
• Taille du texte — de 80 à 140 %, tous les textes d'un même coup.
• Arrondi des angles — de 0 à 20 px, zéro pour des angles vifs.

Espacements

Les volets détaillés

Les vignettes de « Dans la même veine », posées sur le fond du lecteur, gardent leurs propres couleurs ; leur format et leur arrondi suivent le volet Vignettes.

Le lecteur vidéo n'obéit pas à vos styles.
Il vient de Streamlike et vit dans un cadre à lui : ni vos couleurs ni vos retouches CSS ne l'atteignent. Seul le réglage Symbole de lecture et boutons lui est transmis, dans son adresse, et vaut pour toutes vos vidéos, réservées comprises. Ses autres couleurs — barre de progression, fond derrière la vidéo — se règlent dans le back-office Streamlike, dans une configuration de lecteur : elles valent alors aussi pour vos vidéos publiées ailleurs.

Le bandeau part du fond du lecteur.
Sans réglage, sa couleur, son texte et le fond de ses onglets se déduisent de « Bandeau du lecteur ». Dès que vous lui donnez un fond à lui, pensez au fond du groupe d'onglets : la pilule claire d'origine se voit mal sur un fond sombre.

Retouches CSS

Pour ce qui n'est pas prévu, un éditeur accepte vos propres règles de style, appliquées après tout le reste : elles l'emportent. Il colore la syntaxe, signale une accolade manquante, et complète ce que vous tapez :

• hors d'une accolade, le début d'un repère — .swtv .ca ou simplement .car — propose les repères de la WebTV avec leur explication (« .swtv .carte — une vignette cliquable ») ;
• dans une accolade, --acc propose les variables, et col les propriétés CSS, puis leurs valeurs.

Entrée ou Tab accepte la proposition, Ctrl-Espace rouvre la liste. Faites précéder chaque sélecteur de .swtv pour ne toucher qu'à la WebTV. Une référence repliée juste en dessous liste les variables et les repères de style disponibles ; le guide d'intégration les reprend en entier.

Si vous avez désactivé la coloration syntaxique dans votre profil WordPress (Désactiver la coloration syntaxique lors de l'édition de code), le champ reste un simple champ de texte, sans complétion.

Rétablir l'apparence d'origine annule tous ces choix d'un coup.

Boutons, liens et pied de page

Des boutons sous chaque vidéo

Dans Réglages → Intégration → Boutons sur la fiche, chaque ligne crée un bouton : un libellé, et dans la seconde colonne, soit une adresse, soit le nom d'un champ personnalisé Streamlike.

• Une adresse — le bouton apparaît sur toutes les vidéos. Des repères entre accolades y sont remplacés vidéo par vidéo : {titre}, {id}, {lieu}, et le nom de chacune de vos familles, en minuscules, comme {theme}. La liste exacte des repères est rappelée sous le réglage.
• Le nom d'un champ personnalisé — le bouton n'apparaît que sur les vidéos dont ce champ, dans Streamlike, contient une adresse. Les noms trouvés dans votre catalogue sont proposés pendant la saisie.

https://exemple.fr/contact/?video={titre}

Une ligne vide attend en bas de la liste : remplissez-la et enregistrez, une nouvelle ligne libre apparaît. Vider une ligne supprime le bouton. Le premier bouton est mis en avant, les suivants restent plus discrets. Un lien web s'ouvre dans un nouvel onglet, pour ne pas couper la vidéo.

Les adresses commencent par https://, mailto: ou tel:. Si un repère est vide pour une vidéo — un tag absent, par exemple —, le bouton n'apparaît pas sur celle-ci. Le guide d'intégration détaille le cas d'un formulaire de contact prérempli.

Le lien direct vers une vidéo

Copier le lien de cette vidéo, sous la fiche, donne une adresse qui ouvre la WebTV sur cette vidéo, quelle que soit la chaîne où elle est rangée : idéal pour une lettre d'information ou un réseau social. Elle la lance si le réglage Lecture le permet (voir ci-dessous). Quand un visiteur choisit une vidéo, l'adresse de la page change aussi : il peut la copier directement depuis la barre d'adresse.

Le pied de page

Il est vide par défaut. Réglages → Mention du pied de page y place votre texte sur toutes les pages, avec un lien, du gras ou de l'italique si besoin :

Réalisation <a href="https://exemple.fr">Studio Exemple</a>

L'attribut texte le remplace sur une page donnée. Les administrateurs y voient en plus la date d'actualisation du catalogue, avec un lien pour actualiser. Un bouton Effacer ma progression de visionnage s'y ajoute pour les visiteurs qui ont commencé des vidéos, sauf avec historique="non".

Confidentialité

• La clé d'API reste sur le serveur. Elle n'apparaît jamais dans les pages.
• Les pages publiques ne reçoivent que ce qu'il faut pour afficher les vidéos. Ni statistiques, ni lien vers le back-office, ni champs personnalisés — sauf ceux que vous listez dans Champs transmis à la page, qui deviennent alors lisibles par tous. Un champ utilisé par un bouton ne transmet que l'adresse du bouton.
• La progression de visionnage et les choix « dans la même veine » sont gardés dans le navigateur du visiteur (stockage local), et ne sont envoyés nulle part. Le visiteur peut effacer sa progression depuis le pied de page.
• Aucune police n'est téléchargée depuis un service tiers.
• Le lecteur vidéo et les images sont fournis par Streamlike. Ce que le lecteur enregistre relève de Streamlike, à mentionner le cas échéant dans la politique de confidentialité du site. La politique de confidentialité de Streamlike qui couvre sa plateforme vidéo est publiée en anglais : https://www.streamlike.eu/privacy-policy/

Questions fréquentes

La WebTV n'apparaît pas sur la page

Le catalogue n'a sans doute pas encore été récupéré : ouvrez l'onglet Contenu et actualisez-le. Connecté en administrateur, vous verrez un message à l'emplacement de la WebTV qui l'indique ; les visiteurs, eux, ne voient rien. Vérifiez aussi qu'il n'y a pas déjà une WebTV ou des briques ailleurs sur la page.

J'ai mis disposition="grille" et je vois toujours des rangées

C'est normal : grille garde les rangées et leurs titres, et sur des rangées de quelques vidéos une grille ressemble exactement à une rangée. Pour une seule grande grille sans rangées, écrivez disposition="mosaique". Voir disposition.

Un attribut semble ignoré

Vérifiez les guillemets : ils doivent être droits ("), pas typographiques. Vérifiez aussi l'orthographe de la valeur — rangees s'écrit sans accent — et, pour les briques, que l'attribut est accepté par celle qui le porte : titre sur [webtv_chaines], texte et historique sur [webtv_pied].

Une modification faite dans Streamlike n'apparaît pas

Actualisez le catalogue. Les pages lisent la copie gardée dans WordPress, jamais Streamlike directement. Si votre site utilise une extension de cache, videz aussi son cache.

Une vidéo manque

Vérifiez qu'elle est en ligne dans Streamlike, qu'elle appartient bien à l'une des playlists réglées, et que le catalogue a été actualisé depuis. Le compte rendu de l'onglet Contenu signale les vidéos hors ligne écartées. Sur une page réglée avec playlist, seules les vidéos de cette playlist sont présentes. Pensez aussi au format : une vidéo verticale se trouve sous Reels, pas sous Films.

Une vidéo disparaît dès que je filtre, ou une valeur est grisée

Les filtres sont stricts : une vidéo ne reste affichée que si elle porte toutes les valeurs choisies. Une vidéo sans aucun tag de saison disparaît donc sous « Hiver » comme sous « Été », et une valeur grisée — « Jura (0) » — signifie qu'aucune vidéo ne réunit cette valeur et les filtres déjà choisis. Le titre ne compte pas : une vidéo intitulée « … du Jura » sans le tag JURA n'est pas une vidéo du Jura pour la WebTV. Complétez ses tags dans Streamlike ; l'onglet Fiches à compléter liste les vidéos concernées.

Le bandeau des chaînes ne montre rien

Les onglets n'apparaissent que s'il y a au moins deux chaînes à choisir. Trois réglages les suppriment, tous voulus :

• Réglages → Classement et filtres → Plusieurs playlists → Tout ensemble : les playlists sont réunies en une seule vue, et se choisissent dans la barre des filtres, sous Chaîne. C'est le cas d'un portfolio ;
• une seule playlist cochée dans les réglages ;
• l'attribut playlist sur une brique, qui consacre la page à une chaîne.

Sans onglets et sans titre, le bandeau n'a plus rien à montrer : il s'efface, et la brique [webtv_chaines] posée seule ne donne rien. Dans ce cas, mettez un titre de bandeau, passez le réglage en onglets, ou retirez la brique — le choix de la chaîne vit alors dans les filtres. La maquette de l'éditeur vous le dit désormais, avec la raison.

Le côté gauche du bandeau reste vide

Vous avez choisi Apparence → Bandeau et chaînes → Place du titre et des onglets → Titre à gauche, onglets à droite (ou au centre), et la moitié gauche est vide. C'est qu'il n'y a pas de titre : il ne vient pas des réglages mais de l'attribut titre de la brique — le champ Titre du bandeau dans le panneau du bloc, ou [webtv_chaines titre="Ma WebTV"]. Renseignez-le, ou revenez à Onglets à la suite du titre, qui ne laisse aucun vide. La maquette de l'éditeur le signale.

Un filtre ou la carte ont disparu

C'est voulu quand ils n'auraient rien à montrer : une famille sans aucune valeur dans la chaîne affichée ne s'affiche pas, et le bouton Carte disparaît quand aucune vidéo de la chaîne ne porte de position — ou quand la brique [webtv_carte] n'est pas sur la page.

Un point manque sur la carte

Quels tags sont des lieux. Sous les trois choix ci-dessus, des cases à cocher : les tags portés par au moins une vidéo située, rangés par chaîne — un lieu appartient presque toujours à une seule playlist, et une liste alphabétique de vingt tags mêlés se coche à l'aveugle. Un tag porté par plusieurs chaînes va dans un groupe à part. Chaque chaîne a ses raccourcis cocher / décocher, et la zone entière son Tout cocher / Tout décocher. Rien de coché, la carte place toutes les valeurs de la famille principale — sur un catalogue où cette famille prend tous les tags, « Documentaire » et « Été » s'y retrouvent donc, posés au centre de gravité de leurs vidéos, à côté du Cantal. Cochez vos tags de lieux et la carte ne montre plus qu'eux, points et liste à côté. Le reste de la WebTV ne bouge pas : ces tags restent des filtres et des rangées comme avant.

La carte place un point par valeur de la famille principale, à partir des positions de ses vidéos. Une valeur dont aucune vidéo n'a de position reste dans la liste à côté de la carte, sans point. Une position hors de France métropolitaine ne figure pas sur la carte.

Un bouton n'apparaît pas sous une vidéo

Le champ personnalisé de cette vidéo est vide, son adresse ne commence pas par https://, mailto: ou tel:, ou l'un des repères de l'adresse est vide pour elle. Après une modification dans Streamlike, pensez à actualiser le catalogue.

La WebTV paraît étroite

Elle suit alors la largeur du thème : vérifiez que l'attribut largeur="contenu" n'est pas posé. Les briques sont en contenu par défaut : ajoutez largeur="pleine" sur celles qui doivent occuper toute la fenêtre, ou élargissez la section du constructeur qui les contient.

Dans mon constructeur, je vois une maquette au lieu de la WebTV

C'est voulu : un éditeur de constructeur ne peut pas faire tourner la WebTV. La maquette montre l'emplacement, la taille et les réglages de chaque brique ; la page publiée affiche la vraie WebTV. Si votre constructeur montre encore des briques vides et sans mise en forme, il n'a pas été reconnu : un développeur peut l'ajouter en une ligne, voir le guide d'intégration.

L'actualisation s'interrompt

Sur un compte à très nombreuses playlists, ou chez un hébergeur qui limite fortement la durée des traitements, l'actualisation peut dépasser le temps accordé. Réessayez en dehors des heures chargées, ou demandez à votre hébergeur d'allonger cette durée.

Demander de l'aide : le rapport de diagnostic

Tout en bas de Réglages, un encadré Aide et diagnostic porte un rapport tout prêt : version de l'extension, état de la licence, WordPress, thème, constructeur de pages, cache, serveur, état du catalogue et vos réglages d'affichage. Copiez-le et joignez-le à votre message quand vous demandez de l'aide : il évite trois allers-retours.

Il ne contient aucune de vos clés. Ni la clé d'API Streamlike, ni la clé de licence : il dit seulement si elles sont renseignées. Il ne contient pas non plus d'historique de lecture. Il est en clair — relisez-le si vous le souhaitez.

Licence et mises à jour

L'extension ne vit pas dans le répertoire WordPress : elle se vend à part. C'est donc le site de l'auteur qui annonce les nouvelles versions, et votre clé de licence qui ouvre ce service. Collez-la dans Réglages → Licence et mises à jour → Clé de licence.

Ensuite, plus rien à faire : WordPress vous proposera les mises à jour de cette extension comme celles de n'importe quelle autre — la pastille sur le menu Extensions, le bouton Mettre à jour maintenant, le lien Voir les détails.

La réponse du serveur est gardée six heures, pour ne pas l'appeler à chaque page d'administration. L'écran dit donc de quand date ce qu'il affiche — « vérifié il y a 2 heures » — et le bouton Vérifier maintenant redemande tout de suite. C'est ce qu'il faut faire après avoir saisi une clé, ou si votre abonnement vient de changer.

Vérifier à nouveau, sur l'écran Tableau de bord → Mises à jour de WordPress, force lui aussi une vraie demande : une version publiée à l'instant est donc proposée sans attendre.

Une licence échue ne ferme jamais la WebTV. Elle arrête les mises à jour, rien d'autre : vos pages continuent de s'afficher, vos réglages restent, votre catalogue aussi.

Cette clé n'a rien à voir avec votre clé d'API Streamlike : l'une reçoit les mises à jour de l'extension, l'autre va chercher vos vidéos.

Désinstaller l'extension

Désactiver puis supprimer l'extension conserve par défaut vos réglages et votre catalogue, pour une réinstallation sans rien perdre. Pour tout effacer, cochez d'abord Réglages → Entretien → Effacer les réglages et le catalogue si l'extension est supprimée, enregistrez, puis supprimez l'extension. Rien n'est jamais modifié dans votre compte Streamlike.

WebTV for Streamlike · WordPress 6.4 et PHP 7.4 minimum · guide rédigé pour la version 1.30.0