Categories and media
This page is for Songwriters and Admins. Both sections are in the Content group of the admin panel’s sidebar.
Categories
Section titled “Categories”Categories group songs by whatever suits your songbook: by style, by decade, by occasion. A song can be in as many categories as you like. People see a song’s categories at the top of the song, can group the song list by category, and can open a page for each category. See Categories in the browsing guide.
Categories lists every category with its Title, its public address (URL), its Description and how many Songs are in it.
Adding or editing a category
Section titled “Adding or editing a category”Select New category, or a category’s title to edit it. Then fill in:
- Title (required): the category’s name, as people see it.
- Slug: the last part of the category page’s address,
/categories/<slug>. Leave it blank to make one from the title. If another category already has it, Songbook adds-2on the end. - Description: shown at the top of the category’s page.
Select Save. The category list says Category saved. If the title is missing, nothing is saved, and the form says A title is required. beside it.
Changing a slug changes the category page’s address, so older links to it stop working.
To put songs in a category, tick it under Categories in the song editor.
Deleting a category
Section titled “Deleting a category”Open the category, select Delete…, then Delete category to confirm. Only the category goes. Its songs stay in the songbook, and any that were in no other category become uncategorised.
The media library
Section titled “The media library”Media holds the pictures, videos, audio and other files that songs use in their song notes. You can also add files from the song editor as you write, without coming here first.
Every file is public: anyone with its address can open it, whether or not they’re logged in. Pictures, video, audio and PDFs open in the browser; any other file that’s already in the library, such as an SVG uploaded before these rules, downloads instead.
Uploading
Section titled “Uploading”At the top of the page, choose a file, then either choose a folder for it or type a new folder’s name in …or a new folder, and select Upload. The library takes:
- pictures (JPEG, PNG, WebP, GIF or AVIF), up to 8 MB
- video (MP4, WebM or MOV), audio (MP3, M4A, Ogg, WAV or FLAC) and PDFs, up to 25 MB
Songbook checks what the file really is from its contents, not its name. SVG files are refused, because they can carry script, and so are iPhone HEIC photos: on an iPhone, set Camera › Formats to “Most Compatible”, or share the photo as a JPEG. Anything else gets a message saying what the library takes.
Each file is shown as a tile with a preview (or its file type), its name, the folder it’s in, its size, and its full address with a Copy button, for pasting the address anywhere you need it.
Folders
Section titled “Folders”Folders help you find things. They’re labels only: moving a file between folders, or renaming or deleting a folder, never changes the file’s address, so nothing that uses it breaks.
- Filter by folder with the buttons above the files: All, Unfiled, then each folder.
- Move a file by choosing a different folder under its name. It moves straight away.
- Manage folders opens a list where you can Rename or Delete… each folder, or Create a new one. Deleting a folder asks you to confirm with Delete folder. It keeps the folder’s files; they become Unfiled.
There’s also an Avatars folder, holding the pictures people use on their profiles. Avatars are managed from people’s own Settings, so you can’t move, replace or delete them here.
Replacing a file
Section titled “Replacing a file”Select Replace on a file, choose the new file, and select Replace to confirm. The new file takes over the old one’s address, so every song using it shows the new version. The new file has to be the same type as the old one, judged from its contents: a JPEG can only be replaced with another JPEG. The same size limits apply as for uploading.
This is the way to fix a picture that’s already in use. Replacing can’t be undone.
Deleting a file
Section titled “Deleting a file”Select Delete… on a file, then Delete file to confirm.
