Compath Choir Rehearsal

By compath

★ 5.0/5 (1 ratings)0+ active installationsVersion 0.4.74

Choir rehearsal library for voice part rehearsal: songs, up to 4 voice tracks per song, and sheet music.

Description

Choir Rehearsal is a private choir rehearsal library for voice part rehearsal. Singers learn their line with practice tracks and follow a PDF score on the song page.

Features

  • Create songs and attach up to 4 voice tracks per song
  • Built-in voice parts: backing track, bass, baritone, tenor, alto, and soprano, each with 1 and 2, plus Other
  • Upload an MP3 or WAV from the Media Library, or paste a YouTube link on that track
  • The song page plays the official YouTube video in place. Nothing is downloaded
  • Read a PDF score on the song page, turn pages, and expand it to full screen
  • The song editor shows that PDF score and turns its pages
  • Sticky player with play, pause, a waveform, seek, close, and a two-octave piano
  • Each voice track shows a waveform next to the part name
  • Song list at /rehearsal/, 20 songs per page, with a badge for a public song and a badge for YouTube
  • Keep a song private, or mark it public so guests can listen
  • Copy a share link from the song page
  • Place the library on any page with the shortcode [choir_rehearsal]
  • Singer listens. Voice Leader manages songs. Administrator opens Settings. Role names stay in English
  • Optional login-only access for the private library
  • The interface is in English, Estonian, and Russian
  • Signed-in members can send feedback from the song list. A confirmation email includes the case number
  • Optional appearance under Settings → Appearance
  • REST API for listing and reading songs

Sheet music and PDF copyright

Upload only scores you have the rights to use, or that are in the public domain. The plugin asks for confirmation when you attach a PDF and again when you make a song public. It records the WordPress user who confirmed and the time of that confirmation. Compath does not verify those rights. An arrangement or a published edition can still be copyrighted even when the composition is in the public domain.

External services

The rehearsal library works without external services. Song data, audio, and PDF scores stay on your WordPress site.

Optional feedback (under the song list): when someone sends feedback, the site server posts the request to https://rehearsal.compath.ee/api/feedback.php (Compath OÜ). The request includes the message, feedback type, name (optional), email address, WordPress role (or guest), the sender’s locale, plugin version, site home URL, WordPress version, and PHP version. Compath registers a support case and emails a confirmation to the address on the form. No token is stored in the plugin. The email is used only to answer the request.

Optional YouTube tracks (song editor): choose YouTube as a track source and paste a URL. The song page opens the official YouTube embed player (youtube.com). Playback uses YouTube’s embed; no download. Subject to YouTube Terms of Service. No YouTube API key is required for this embed.

Optional documentation link in Settings may open rehearsal.compath.ee (Compath OÜ) for help and changelog. No site or user data is sent unless you open that page in your browser.

PDF viewing uses Mozilla PDF.js bundled inside the plugin (Apache-2.0). No PDF.js CDN calls are made.

Privacy

Choir Rehearsal stores rehearsal content on your WordPress site.

When someone confirms a PDF score upload, the plugin saves that WordPress user ID and the confirmation time in the song post meta _choir_score_rights_confirmed_by and _choir_score_rights_confirmed_at. When someone confirms making a song public, it saves the same kind of record in _choir_public_rights_confirmed_by and _choir_public_rights_confirmed_at.

Uploaded PDF scores and audio files are stored in the site media library.

The optional feedback form sends the data described under External services to rehearsal.compath.ee (Compath OÜ).

Under Settings → Privacy, WordPress can insert suggested policy text from this plugin for the confirmation records and uploaded files.

Installation

  1. Upload the plugin folder to /wp-content/plugins/compath-choir-rehearsal
  2. Activate the plugin through the ‘Plugins’ menu in WordPress (this creates roles Singer and Voice Leader)
  3. Assign users under Users: Singer to listen, Voice Leader to manage songs
  4. Go to Choir Rehearsal → Add Song (Voice Leader or Administrator)
  5. Share /rehearsal/ with your choir — Settings remain Administrator-only

FAQ

Who can view rehearsal pages?

By default the full private library needs a Singer, Voice Leader, or Administrator account. Guests still see songs marked public. Change login behaviour under Choir Rehearsal → Settings (Administrators only).

What are Singer and Voice Leader?

WordPress roles created on plugin activation. Names stay in English. Singer listens; Voice Leader manages songs in wp-admin; Administrator also opens plugin Settings.

Can I embed the song list in a page?

Yes. Use the shortcode [choir_rehearsal].

How do singers send feedback?

Signed-in users see Send feedback under the song list. Logged-out visitors do not. Administrators and Voice Leaders also open the same form from Choir Rehearsal → Send feedback in wp-admin. Email is required. After a successful send, the page shows the case number and Compath emails a confirmation to that address. No GitHub token is required.

Can I upload PDF sheet music?

Yes, when you have the rights to use that score, or the score is in the public domain. The plugin asks you to confirm this when you attach a PDF and when you make a song public. It records who confirmed and when. Compath does not verify those rights. Arrangements and editions can be copyrighted even if the composition is in the public domain.

Can I use YouTube instead of an audio file?

Yes. In the song editor, set a voice track’s source to YouTube and paste a youtube.com or youtu.be URL. On the song page a button opens the official YouTube embed (video stays visible). This is for listening/reference only — the plugin does not download or convert YouTube audio.

Changelog

0.4.74

  • Readme: corrected track limit and feature list
  • Plugin details: Compatible up to follows the readme Tested up to value

0.4.73

  • Maintenance release.

0.4.72

  • New optional Appearance (Settings → Appearance)

0.4.71

  • Maintenance release.

0.4.70

  • Maintenance release.

0.4.69

  • Maintenance release.

0.4.68

  • Maintenance release.

0.4.67

  • Before attaching a PDF score, require confirmation of copyright rights or public domain
  • Server rejects a new PDF without confirmation; stores confirmation audit meta
  • Before making a song public (globe), warn about PDF copyright risk and require confirmation to publish
  • Plugin listing: sheet-music copyright, who confirmed and when, and a privacy note for confirmation records and media-library files
  • WordPress.org short description highlights voice part rehearsal
  • Suggested privacy policy text for score-rights confirmation and uploaded files
  • Refresh Estonian and Russian translations for the confirmation strings

0.4.66

  • Song list feedback form is hidden from logged-out visitors. Signed-in users still see it. Choir Rehearsal → Send feedback stays in wp-admin

0.4.65

  • Choir Rehearsal → Send feedback: the same feedback form on its own admin page

0.4.64

  • Song list: Send feedback for bugs and wishes. The page shows the case number and a confirmation is emailed to the address on the form

0.4.63

  • Keeps Cyrillic hex-dump repair from 0.4.62

0.4.62

  • Fix Cyrillic song permalinks: WordPress percent-encoded titles no longer become hex dumps like d0-9f-d0-b5…
  • Repair existing hex-dump / non-Latin song slugs on upgrade

0.4.61

  • Per-track Audio / YouTube source switch in the song editor
  • YouTube tracks open the official embed player on the song page (video stays visible)
  • Song list shows a YouTube icon next to PDF and public badges when a song has a YouTube track

0.4.60

  • Add WordPress roles Singer (listen) and Voice Leader (manage songs); names stay in English
  • Song admin for Voice Leader and Administrator; Settings for Administrator only
  • Full private library requires Singer, Voice Leader, or Administrator

0.4.59

  • Song list: globe icon for public songs when logged in; spacing between PDF and globe badges

0.4.58

  • Force HTTPS for PDF and audio attachment URLs on SSL pages (fixes mixed-content blank PDF/waveforms in wp-admin)

0.4.57

  • Keep the songs library URL permanently at /rehearsal/ (never localize the page slug)

0.4.56

  • Fix Russian (and Estonian) translation mojibake in .l10n.php catalogs
  • Ship UTF-8 PO/MO/l10n.php for et, et_EE, and ru_RU

0.4.55

  • Fix blank PDF canvas in the song editor when SoftMe metabox width is 0
  • Defer PDF.js paint until the viewer has a usable layout width

0.4.54

  • SoftMe/Softica sticky player icon and editor PDF visibility fixes from 0.4.53

0.4.53

  • Theme-proof sticky player piano and close icons (SoftMe/Softica button color overrides)
  • Editor PDF: re-render when metabox becomes visible; refresh on postbox toggle

0.4.52

  • Fix duplicate Lite notice when only one folder exists: repair ghost/duplicate rows in active_plugins
  • Migration wizard: show active_plugins Lite entries and one-click repair

0.4.51

  • WordPress.org: remove global sanitize_title filter; song slugs only via wp_insert_post_data / save_post
  • WordPress.org readme: external services limited to optional documentation link and bundled PDF.js

0.4.50

  • Universal install/replace: upload or update replaces choir-rehearsal/ or compath-choir-rehearsal/ instead of adding a second copy
  • After install, extra Lite folders are removed automatically (songs stay in the database)
  • Fix update check on older installs: merge all update sources and pick the highest version (avoids stale 0.4.21 from main-branch update.json)
  • Check for updates redirects to Plugins when an update is available; clearer notice when the server reports an older version than installed

0.4.49

  • Migration wizard: detect duplicate Lite folders, keep one, deactivate/delete extras without deleting songs
  • Dual-load copy can open the wizard even when an older Lite loaded first

0.4.48

  • Updates/uploads stay in the already-installed plugin folder (stops a second Lite copy after upgrade)
  • Duplicate-plugin notice lists active Lite paths

0.4.47

  • GitHub zip again installs into folder choir-rehearsal/ (fixes duplicate plugin after upload on existing sites)

0.4.46

  • Align text domain with WordPress.org slug (compath-choir-rehearsal)

0.4.45

  • Clearer duplicate-plugin admin notice

0.4.44

  • Fix piano keys sticking visually after press on the public song player

0.4.43

  • Fix: activating beside an old choir-rehearsal folder no longer fatals; shows an admin notice instead
  • Keep only one plugin copy active (prefer folder compath-choir-rehearsal)

0.4.42

  • Fix: replace wp_dropdown_pages with an escaped custom select (Plugin Check)

0.4.41

  • Fix: remaining Plugin Check issues (wp_dropdown_pages escaping, login redirect nonce)

0.4.40

  • Fix: Plugin Check errors (escaping, translators comments, wp_delete_file)
  • Fix: Plugin Check warnings (sanitization, prefixed uninstall vars, textdomain)

0.4.39

  • Brand: plugin renamed to Compath Choir Rehearsal (slug compath-choir-rehearsal) for WordPress.org
  • Package folder and GitHub release zip use compath-choir-rehearsal

0.4.38

  • Fix: mobile fullscreen PDF close (X) appears above sticky player and recording dock
  • Fullscreen PDF toolbar includes a Close control for reliable exit on small screens

0.4.37

  • Fix: PDF page navigation works again (same-size pages were skipped by render guard)

0.4.36

  • Fix: desktop scrubber works for microphone WebM recordings (Chrome Infinity duration)
  • New mic uploads are converted to WAV when needed so seeking works reliably

0.4.35

  • Fix: song page / editor freeze caused by recording-dock body class observer
  • PDF viewer skips redundant re-renders that could lock the UI

0.4.34

  • Mobile: floating recording bar (record / pause / stop / cancel) above the player when controls scroll away or PDF is expanded
  • Mic recording supports pause and resume from the same take

0.4.33

  • Recording: larger piano and metronome icons
  • Sticky player: metronome only in mic recording (removed from player bar)
  • Sticky player: remove white frame around waveform scrubber on the public song page
  • Song view: reliable X control to exit expanded PDF

0.4.32

  • Sticky player and song editor: metronome panel with tempo slider (40–208 BPM)
  • Recording row: Start / piano / metronome at 70% / 15% / 15%

0.4.31

  • Sticky player: hide track title on waveform; time + close sit to the right of scrubber

0.4.30

  • Song editor: piano icon beside Start recording (70% / 30% row)

0.4.29

  • Sticky player: open a scrollable 2-octave Web Audio piano above the player

0.4.28

  • Sticky player: waveform only behind scrubber (no white seek track)
  • PDF expand fits page to screen width; expand toggles to matching X control
  • Pinch-zoom keeps the chosen scale instead of snapping to 100%

0.4.27

  • Sticky player: waveform is the scrubber background (compact single-row bar)

0.4.26

  • Song editor: show track waveform instead of the audio filename
  • Sticky player: waveform under the seek bar

0.4.25

  • Voice tracks show a blue waveform from the track name to Play/Upload
  • Waveforms are generated from each track’s audio file in the browser

0.4.24

  • Play buttons always blue with white icon/text (theme-proof)
  • PDF: full-screen expand with close control; sticky player stays visible below
  • PDF: pinch-to-zoom (and Ctrl/trackpad zoom)

0.4.23

  • WordPress.org package: remove GitHub updater file entirely (Plugin Check)
  • readme.txt: Tested up to 7.1

0.4.22

  • WordPress.org ready: disable GitHub self-updater in .org packages
  • Bundle PDF.js locally (no third-party CDN for scripts)
  • Settings: WordPress.org builds show “Updates via WordPress.org”

0.4.21

  • Fix: updater treats non-2xx GitHub API responses as failures (rate limits no longer look like empty release lists)
  • Fix: durable update.json fallback via GitHub release asset (/releases/latest/download/update.json)
  • Settings: Check for plugin updates redirects back with clear notices (available / up to date / failed)
  • Settings: show last update-check result under Plugin version

0.4.20

  • Fix: PDF score preview no longer blanks in the song editor after the form loads
  • PDF.js loads without credentials first (avoids hung credentialed fetches in wp-admin)
  • Song save no longer deletes an attached PDF when the metabox field is missing or mime is unexpected

0.4.19

  • Share: one-tap copy link with on-screen confirmation (no dual public/private menu)
  • Fix mobile Share toast so it stays on screen
  • Song editor: fix Play icon (large white triangle in blue circle)

0.4.18

  • Song permalinks: auto-transliterate any language title to a Latin slug
  • Fix permalink editing so custom slugs save correctly
  • Migrate existing non-Latin song URLs on upgrade

0.4.17

  • Song page: Share icon to copy public or private song links

0.4.16

  • Make public control on the song editor card (icon on mobile)
  • Guests can browse and listen to public songs without signing in
  • Private songs still require login when that setting is enabled

0.4.15

  • Song editor matches the public song card: embedded PDF with swipe page turns
  • Voice track rows use listen-style layout with Upload / Record / Play icon buttons
  • Removed the unreliable floating PDF panel

0.4.14

  • Sticky player: close (×) button on the right — hides the player so mobile Update / content is reachable

0.4.13

  • Mobile song editor: keep “Back to song list” at the top (visible with sticky player)

0.4.12

  • Maintenance release.

0.4.11

  • Song editor: Play button on voice tracks opens the sticky player

0.4.10

  • Demo song titles use zero-padded numbers (Demo Song 01, 02, …) so A–Z sort stays in order

0.4.9

  • Load demo songs creates 25 songs so library pagination (20 per page) appears after one click

0.4.8

  • Settings: Load demo songs (10 songs × 4 tracks with demo voice audio)
  • Settings: Delete all songs with Yes/No confirmation (removes tracks, media, songs)

0.4.7

  • Maintenance release.

0.4.6

  • Fix double “Update now”: clear update cache after upgrade and compare version from disk

0.4.5

  • Maintenance release.

0.4.4

  • Maintenance release.

0.4.3

  • Maintenance release.

0.4.2

  • Song list pagination (20 songs per page) for large libraries
  • Mobile: search field spans full width above the song list

0.4.1

  • Maintenance release.

0.4.0

  • Lite edition: up to 4 voice tracks per song, no microphone recording
  • Edition label and upgrade link in Settings

0.3.11

  • Mobile-friendly sticky player: wider controls, large play button, seek bar

0.3.10

  • Plugin author shown as Compath OÜ (was Cappella Veneta in older builds)

0.3.9

  • Product page URL set to rehearsal.compath.ee

0.3.8

  • Product documentation page (order, install, pricing, changelog)
  • Documentation link on Settings page

0.3.7

  • Fix desktop layout: Publish sidebar no longer overlaps song title

0.3.6

  • Fix: song title field visible again on edit screen

0.3.5

  • Mobile song editor: Back to song list button (top and sticky footer)

0.3.4

  • Simplified song editor: title, PDF score, and voice tracks only
  • Removed WordPress content editor and extra meta boxes
  • Mobile: main fields first, sticky Save/Publish bar at bottom

0.3.3

  • Mobile-friendly admin layout for voice tracks (compact select and buttons)

0.3.2

  • Fix microphone recording upload (video/webm and file type validation)
  • Show specific server error when upload fails

0.3.1

  • Show installed plugin version on the Settings page

0.3.0

  • Record voice tracks from microphone in the song editor (MediaRecorder API)
  • Recordings upload directly to the WordPress Media Library

0.2.6

  • Fix duplicated login form caused by multiple [choir_rehearsal] shortcodes on the page

0.2.5

  • Fix critical error after v0.2.4 upgrade

0.2.4

  • Rehearsal library now uses a standard WordPress page with [choir_rehearsal] shortcode
  • Auto-creates /rehearsal/ page and refreshes permalinks on upgrade
  • Settings: choose rehearsal page and add it to WP menus

0.2.3

  • Fix GitHub update check (repository URL encoding returned 404)
  • Fallback update metadata from update.json in the repository
  • “Check for updates now” button in settings

0.2.2

  • Frontend login screen on rehearsal pages instead of redirect to wp-login.php
  • Role-based toolbar: editors manage songs, singers view and listen only

0.2.1

  • WordPress-native plugin updates via GitHub Releases or custom JSON URL

0.2.0

  • PDF sheet music attachment per song
  • PDF viewer with previous/next page controls on song pages

0.1.0

  • Initial release: songs, tracks, sticky player, REST API, MCP abilities.