KU Leuven Proxy Setup

Automatic import of name, credits, semester and contact hours from KU Leuven ECTS sheets.

1. Create the Worker (no command line)

1. Create a free account at dash.cloudflare.com.
2. Left menu → Workers & Pages → Create → Create Worker.
3. Give it a name, e.g. kul-proxy, and click Deploy.
4. Click Edit code. Delete the sample code, paste the full contents of kuleuven-proxy-worker.js, and click Deploy (top right).
5. Your Worker URL now appears at the top, e.g. https://kul-proxy.<yourname>.workers.dev. Copy it.

2. Connect it to the app

1. Open the Study Load Planner, tab 1 · Vakken.
2. Paste the Worker URL into the Proxy-URL field (it is remembered).
3. Test right away: paste a course-sheet URL such as https://onderwijsaanbod.kuleuven.be/syllabi/n/L00A2DN.htm and click Ophalen. If the course appears with contact hours, everything works.

3. How to use it

• One course: paste a sheet URL (…/syllabi/n/XXXXXN.htm) → Ophalen.
• One study year: paste a programme URL (…/opleidingen/n/SC_…), choose the Fase (1, 2 or 3) in the dropdown, and click Ophalen. The planner imports only that year's courses (e.g. Fase 1 = the 60 credits of year one), with contact hours included.
• Whole programme: leave the dropdown on Alle fasen to import every year at once.
• Fill hours only: if you already added courses via the paste import, click Contacturen aanvullen voor bestaande vakken to fetch just the contact hours.

4. Security (recommended)

Near the top of kuleuven-proxy-worker.js you'll find:

const ALLOW_ORIGIN = "*"; // → set to "https://bunka.be" for production

Set this to your own domain so only your site may use the proxy, then deploy again.

5. If it doesn't work

• An error with HTTP 403 / blocked / empty sheet: KU Leuven is blocking Cloudflare's data-centre IP (as it does with public proxies). In that case a simple proxy won't do, and a heavier solution is needed (a headless-browser service), or keep using the paste route.
• "Geef eerst je proxy-URL in": the Proxy-URL field in the app is empty.
• A CORS error in the console: check that ALLOW_ORIGIN allows your domain (or *) and that you re-deployed after changing it.
• Nothing found on a programme page: confirm the URL is really from onderwijsaanbod.kuleuven.be and is a programme or course-sheet page.

Technical note

Parsing is validated against a real sheet: from …/syllabi/n/L00A2DN.htm the Worker correctly reads "Natuurkunde en inleiding tot de biomechanica", 6 studiepunten, 52 uren (contact hours) and Eerste semester. The sheet pages are server-side HTML (no separate data API), so extraction uses simple patterns on the HTML. If KU Leuven changes the layout of those pages, the Worker may need a small update.