Embedding Guide

Learn how to embed thesis topics on your institute or personal website.

Overview

Embed thesis topics on your institute homepage or personal website using an iframe. Topics stay synchronized with the central system automatically.

💡 Tip

Use showLayout=false to hide the header/footer, and padding=0 to remove page padding for a seamless embed. Using showFilters=false will hide filter controls.

Quick Start

The base URL for embedding:

/thesis-topics?showLayout=false&showFilters=false&padding=0

Add parameters using &:

/thesis-topics?showLayout=false&showFilters=false&padding=0&perPage=6

ℹ️ Note on Status

By default, all queries show only “Announced” topics without displaying a status badge. If you explicitly add status=Announced to the URL, the status badge will be displayed on the results. Only add the status parameter if you want to show the badge or filter by a different status.

Card View Examples

The default card view displays topics in a responsive grid layout.

Basic Card Embed

Uses perPage=6 to show 6 topics per page. Add showPagination=false to hide pagination.

/thesis-topics?showLayout=false&showFilters=false&padding=0&perPage=6

Master Thesis Topics Only

Uses level=master to filter for Master-level topics only.

/thesis-topics?showLayout=false&showFilters=false&padding=0&level=master&perPage=6

Table View

Use style=table for a compact table layout. This is useful when you need to show more topics in less vertical space.

Table View

Uses style=table for a compact table layout. Add showPagination=false to hide pagination.

/thesis-topics?showLayout=false&showFilters=false&padding=0&style=table&perPage=8

💡 Filter by Supervisor

Show only topics offered by a specific person using the search parameter with their name. This is perfect for embedding on personal or institute pages.

<iframe
  src="/thesis-topics?showLayout=false&showFilters=false&padding=0&search=Prof.%20Smith"
  width="100%"
  height="500"
  style="border: none;"
  title="Thesis Topics - Prof. Smith"
></iframe>

⚠️ Note

URL-encode special characters in names. Spaces become %20, and ü becomes %C3%BC.

Best Practices

Set an appropriate height

Rule of thumb: ~180px per card row, or ~50px per table row.

Use responsive width

Always use width="100%" for responsive layouts.

Add a title attribute

Include a descriptive title for accessibility.

What if you hate any of this?

If iframes aren't your thing or you need complete control over the display, the headless WordPress CMS exposes an open REST API that you can use to fetch and display data any way you like.

🔌 REST API

Build your own custom integration using the REST API. Perfect for:

Custom designs that match your brand
Advanced filtering and sorting logic
Integration with existing systems
Mobile apps or other platforms

API Documentation:

https://thesis.isp.uni-luebeck.de/admin/rest-api/schema

Look under GET thesis-topics for the endpoint documentation.

All Parameters

Complete reference of all available URL parameters.

Display Controls

Parameter	Type	Default	Description
`showLayout`	boolean	`true`	Show/hide the site header and footer. Set to 'false' for embedding.
`showFilters`	boolean	`true`	Show/hide the filter controls (search, level, tags, etc.).
`showPagination`	boolean	`true`	Show/hide the pagination controls at the bottom.
`style`	string	`cards`	Display style: 'cards' for card grid or 'table' for table view.
`padding`	string	`1rem`	Control the padding of the page container (e.g. '0', '20px').

Pagination

Parameter	Type	Default	Description
`page`	number	`1`	Current page number for pagination.
`perPage`	number	`12`	Number of topics to display per page.

Filtering

Parameter	Type	Default	Description
`search`	string	—	Free-text search query. Searches titles, descriptions, and author names.
`level`	string	—	Filter by study level (e.g., 'Bachelor', 'Master').
`tags`	string	—	Comma-separated list of tags to filter by.
`authors`	string	—	Comma-separated list of author/supervisor names.
`status`	string	`Announced`	Topic status filter (e.g., 'Announced', 'In Progress', 'Completed').
`startDate`	string	—	Filter topics from this date (format: YYYY-MM-DD).
`endDate`	string	—	Filter topics until this date (format: YYYY-MM-DD).

Sorting

Parameter	Type	Default	Description
`sort`	string	`date-desc`	Sort order: 'date-desc', 'date-asc', 'title-asc', 'title-desc'.

🤔

Need Help?

Questions about embedding? Contact the ISP at office@isp.uni-luebeck.de

💡 Tip: You can generate a suitable URL by applying filters on the thesis topics page and copying the generated URL from your browser's address bar.

View Full Thesis Topics