Storyblok Companion

Storyblok's story list shows you what is in a folder. This adds what you need to do something with it. REORDER BY DRAGGING Press anywhere on a row and drag the story to where it belongs. A dialog names the change, and the new order is saved to Storyblok when you confirm it. Tick a few rows first and dragging any one of them carries the whole selection, which lands as one block wherever you drop it. Dragging across a row's text starts a drag rather than selecting the text; the copy icons below are where to take it from instead. Reordering only ever shuffles the position values a folder already holds, so it is safe on one page of a long, paginated folder — nothing you drag collides with the pages you cannot see. And when an order cannot be saved safely, the drop is refused with the reason rather than writing something that will not survive a refresh: the view spans folders, it is sorted by a column, or two stories share a position. Point at a gap on such a list and it says so before you let go. MOVE INTO A FOLDER BY DRAGGING Drop a story, or a ticked selection, onto a folder row instead of between rows and it moves into that folder, placed after whatever is already there. Drop it on a breadcrumb instead and it moves up: into that ancestor, or to the root. A deep trail folds its top folders behind “…”; drag over it and they open. The folder is checked first, and a slug it already holds refuses the move before anything is written. A dialog says what will change: the story keeps its slug and gets a new full slug, so links to the old one break. COPY A NAME OR A FULL SLUG BY POINTING AT IT Point at a story's name and a copy icon appears beside it; point at the slug under it and the icon moves there, taking the full slug the list never shows. The same icons are in the story editor's header, on whichever story you have open, and point at a folder in the breadcrumbs for one that takes its full slug. Wherever you see it, the icon with a slash takes a full slug. The two things you most often need to paste somewhere are one click away wherever you are looking at them. For everything else, a button beside each row's favorite star opens a card holding those two and the rest — slug, story ID, UUID and position. Click any one of them to copy it: no opening the story to read its UUID, no digging through the network tab for an ID. SORT A FOLDER ALPHABETICALLY The extension's mark in the corner of the page will put a whole folder in order of name. It reads every page first, so the order holds across a folder far too long to fit on one screen, and it says how many stories it is about to rewrite — including the ones that are not in front of you — before it writes anything. Folders sort in among the stories by name, or all together at the top if you tick the box. “Chapter 2” comes before “Chapter 10”, and a name typed in a different case sorts beside its neighbours instead of ahead of all of them. The order is written once, into the positions Storyblok keeps, so it is the order the folder has from then on — in the app, in the API, and in anything you build off it. Renaming a story later does not move it; run the sort again. This is offered while the list is in the folder's own order. Sort the view by a column and it goes away: that sort belongs to the table, not to the folder, and rewriting every position to match it would not change a single row you can see. REPAIR DUPLICATE POSITIONS Storyblok lets two stories hold the same position, and then nothing can put them in a definite order — including dragging, above. When that happens, the button at the end of each affected row turns into a yellow warning triangle, so you can see which stories are the ones sharing a number, and opening one leads with the warning above its fields. The extension's mark appears in the corner of the page, and renumbering the folder is what it offers. It reads every page first, says exactly how many stories it is about to rewrite, including the ones not on the page in front of you, and asks before it writes anything. IT STAYS OUT OF THE WAY Colours come from Storyblok itself, so the extension follows whichever theme you use. Nothing is inserted into the app's own markup — the controls float above the list — so nothing about Storyblok works differently while it is installed. The mark in the corner is only there when there is something to do with it, and you can drag it anywhere in the window. Works on app.storyblok.com and app.storyblokchina.cn. PRIVACY No account, no analytics, no servers of our own. Every request goes to Storyblok's own API from your browser tab, with the session you are already signed in to. Nothing is sent anywhere else. ABOUT THE INSTALL NOTICE Chrome may tell you this extension is not trusted by Enhanced Safe Browsing. That is what Chrome shows for any listing published recently, whatever is in it; it clears once the listing has been on the store a few months. It is not a finding about this extension.