Usage and frequently asked questions

Regionalportal West (regio-west.de) aggregates local news, job offers and events from western Germany. Content comes from primary sources on site and is provided per place as well as across places. The portal is free of charge and free of advertising.

This page explains how to use the public screens in detail: place suggest and Germany map on the home page, lists with GET filters place, period and job_type including allowed values, technical examples and real-world examples, parameter and result tables, infinite scroll and the global feedback widget. There is no classic free-text global search across all content and no globe.

The table of contents jumps to the intro, usage steps and FAQ. Public screens are linked as path links with a leading slash and without a host. Parameter, result and feedback tables document fields and HTML locations from this host.

How to use the website

Home page and place suggest

/ The home page shows a portal explanation, a Germany map with place hotspots, a place suggest box and place tiles. In the suggest box, free text filters enabled places client-side by name and region; selection opens the place portal of the chosen place. Benefit: fast entry into local content without a global search. Typical flow: type a place, choose a suggestion, open the place portal.

Header lists for news, jobs and events

/nachrichten/, /stellen/, /veranstaltungen/ The header navigation opens the news, jobs and events lists. There is no free-text global search across all content; navigation leads directly to the lists. Typical flow: open a list screen, set filters, scroll results. Benefit: thematically separated entry points instead of a mixed global search.

List filters place, period and job_type

GET place (UI label Place / All places): missing, empty or all means all places; otherwise an exact place slug from the places config. Technical examples: blankenheim, mechernich, kall, euskirchen, schleiden. Real-world example: show only Blankenheim content with place=blankenheim. Used on news, jobs and events. GET period (UI label Period): today, yesterday, last_7_days, this_month, this_year, last_year; UI start value last_7_days; cookie place_news_period remembers the choice. Technical examples: period=today, period=last_7_days, period=this_year. Real-world example: only today town-hall notices with period=today. Used on news and place news. GET job_type (UI label Job type): missing, empty or all means all types; otherwise exactly Festanstellung, Teilzeit, Minijob, Ausbildung, Duales Studium, Praktikum, Werkstudent, Aushilfe, Freelance or Befristet. Technical examples: job_type=Festanstellung, job_type=Teilzeit, job_type=Ausbildung. Real-world example: regional apprenticeships with job_type=Ausbildung. Used on jobs and place jobs. The result list updates via AJAX and History API; further entries come via infinite scroll / load-more under /nachrichten/more/, /stellen/more/, /veranstaltungen/more/. Benefit: bookmarkable URL with the same filters.

Parameter table news (/nachrichten/)

Parameter
UI name
Purpose
Technical examples
Real-world example
place
Place / All places
Restricts the news list to an enabled place slug.
blankenheim; mechernich; kall; euskirchen; schleiden; all
Show only news from Blankenheim with place=blankenheim.
period
Period
Filters news by found-at period; cookie place_news_period remembers the choice.
today; yesterday; last_7_days; this_month; this_year; last_year
Check only today town-hall notices with period=today.

Parameter table jobs (/stellen/)

Parameter
UI name
Purpose
Technical examples
Real-world example
place
Place / All places
Restricts the job market to an enabled place slug.
blankenheim; mechernich; kall; euskirchen; schleiden; all
Show only jobs from Mechernich with place=mechernich.
job_type
Job type
Filters jobs by employment type from the job-types config.
Festanstellung; Teilzeit; Ausbildung; Minijob; Praktikum
Find regional apprenticeships with job_type=Ausbildung.

Parameter table events (/veranstaltungen/)

Parameter
UI name
Purpose
Technical examples
Real-world example
place
Place / All places
Restricts events to an enabled place slug.
blankenheim; mechernich; kall; euskirchen; schleiden; all
Show only events in Kall with place=kall.

Result fields and HTML locations

Each hit shows fixed fields at fixed HTML locations of this host. News: title, place, teaser, found-at. Jobs: title, place, job type, description, found-at. Events: title, place, start, location, description, found-at. The tables below name field, content and HTML location (ID or class). Benefit: people and machines can map result fields unambiguously.

Result table news

Fields of a news hit with HTML locations from the screen-news template.

Field
Content
HTML location
Title
Headline of the notice, often as link to the primary source via clickout.
.news-item-title / .news-item-link
Place
Place name with link to the place portal.
.news-place / .news-place-link
Teaser
Short text of the notice.
.news-teaser
Found at
Time when the notice was found.
.news-found-at
List item
Wrapper of one hit in the news list.
#news-item-{n} / .news-item

Result table jobs

Fields of a job hit with HTML locations from the screen-jobs template.

Field
Content
HTML location
Title
Job headline with link to the primary source.
.place-job-card-title / .place-job-card-title-link
Place
Place name with link to the place jobs list.
.place-job-card-place / .place-job-card-place-link
Job type
Employment type as badge.
.place-job-card-badge / .place-job-card-badge-link
Description
Short job description.
.place-job-card-description
Found at
Time when the job was found.
.place-job-card-found-at
List item
Wrapper of one job hit.
#jobs-item-{n} / .jobs-item

Result table events

Fields of an event hit with HTML locations from the screen-events template.

Field
Content
HTML location
Title
Event headline with link to the primary source.
.place-event-card-title / .place-event-card-title-link
Place
Place name with link to the place portal.
.place-event-card-place-link
Start
Start time as badge.
.place-event-card-badge
Location
Venue text as badge.
.place-event-card-badge
Description
Short event description.
.place-event-card-description
Found at
Time when the event was found.
.place-event-card-found-at
List item
Wrapper of one event hit.
#events-item-{n} / .events-item

Place portals and place subpages

Place portals and subpages for city facts, place news, jobs and events with infinite scroll are catch-all paths. They are reached via the home page and the place suggest box. Placeholder paths are explanatory only; entry remains the home page. Benefit: local entry without typing long paths. /

Clickout to primary sources

/out/ External primary sources open via the clickout interim page before the original page loads. Benefit: transparent transition from portal content to the source. Typical flow: click a hit link, see clickout briefly, reach the original source.

Feedback widget

The global feedback widget opens a modal via the toggle button. In the form, required field message is free text; after normalisation at least five Unicode characters are required. Submit sends the message to API path /feedback. Close and Escape end the modal. Status messages appear in the status area. Benefit: quick website feedback without a lengthy contact enquiry. Contact form fields are not catalogued here.

Feedback widget operation and HTML locations

Element
Purpose
HTML location
Technical details
Toggle
Opens or closes the feedback modal.
#feedbackWidgetToggle
Button; controls aria-expanded and modal visibility.
Modal
Dialog for feedback input.
#feedbackWidgetModal
role=dialog; Escape closes.
Message
Required free-text field.
#feedbackWidgetMessage
POST name=message; minimum length 5 Unicode characters after normalisation.
Submit
Sends the feedback.
#feedbackWidgetSubmit
Submit to API path /feedback.
Close
Closes the modal without submitting.
#feedbackWidgetClose
Button type=button.
Status
Shows success or error after submit.
#feedbackWidgetStatus
Live status area in the modal.

Language switching

UI languages German, English, Spanish and Ukrainian (de, en, es, uk) are switched via the header flags (parameter lang). Without lang in the URL the session language is kept. Benefit: same operation in all host languages.

Legal pages

/imprint, /privacy, /terms Imprint, privacy and terms are reachable via the footer and do not replace the usage guide. They complement the grounding page with legal information. Typical flow: choose a footer link and read the text.

Frequently asked questions

What is Regionalportal West?

Regionalportal West is a regional portal for local news, jobs and events from western Germany. Content comes from primary sources and is shown per place as well as across places. The portal is free and ad-free and aims at people who want local information without a global search.

Is there a free-text global search?

No, there is no global search across all content. On the home page the place suggest box filters enabled places client-side by name and region. Header links lead to lists with GET filters place, period and job_type plus infinite scroll. To find a place, use suggest or tiles; for topic lists open news, jobs or events and set filters.

What is GET parameter place for?

GET name place. UI label Place / All places. Purpose: restrict cross-place lists to one enabled place so hits only show for that place. Allowed values: missing, empty or all for all places; otherwise exact place slug from places config. Technical examples: blankenheim, mechernich, kall, euskirchen, schleiden. Real-world example: only Blankenheim content with place=blankenheim. Used on news, jobs and events. The URL stays bookmarkable; on change AJAX replaces the list and the History API updates the query string.

/nachrichten/, /stellen/, /veranstaltungen/

What is GET parameter period for?

GET name period. UI label Period. Purpose: filter news by found-at period so only notices from the chosen window are visible. Allowed values exactly: today, yesterday, last_7_days, this_month, this_year, last_year. UI start value last_7_days; cookie place_news_period remembers the choice across places. Technical examples: period=today, period=last_7_days, period=this_year. Real-world example: only today town-hall notices with period=today. Used on news and place news. Typical flow: choose period, list and count update via AJAX, infinite scroll restarts.

/nachrichten/

What is GET parameter job_type for?

GET name job_type. UI label Job type. Purpose: filter jobs by employment type so only matching offers remain. Allowed values: missing, empty or all for all types; otherwise exactly Festanstellung, Teilzeit, Minijob, Ausbildung, Duales Studium, Praktikum, Werkstudent, Aushilfe, Freelance or Befristet from job-types config. Technical examples: job_type=Festanstellung, job_type=Teilzeit, job_type=Ausbildung. Real-world example: regional apprenticeships with job_type=Ausbildung. Used on jobs and place jobs. Combined with place, place and type can be set together; load-more keeps the same parameters.

/stellen/

How does the feedback widget work?

Toggle button feedbackWidgetToggle opens modal feedbackWidgetModal. In form feedbackWidgetForm, message is the required field in feedbackWidgetMessage; after normalisation at least five Unicode characters are needed. Submit via feedbackWidgetSubmit to API path /feedback. Close via feedbackWidgetClose or Escape. Status in feedbackWidgetStatus. Benefit: quick website feedback. Contact form fields are not described here.

Which fields does a news hit show and where in HTML?

Each news hit is in #news-item-{n} or .news-item. The title is in .news-item-title and as link in .news-item-link. The place appears in .news-place with link .news-place-link. The teaser is in .news-teaser. Found-at is in .news-found-at. Filter changes update list and count via AJAX; further hits come via infinite scroll.

/nachrichten/

Which languages exist and where are legal and clickout pages?

UI languages are German, English, Spanish and Ukrainian (de, en, es, uk). Switching uses header flags with parameter lang. Without lang in the URL the session language stays unchanged. Imprint, privacy and terms plus the clickout interim page complement the public flows and are reachable via the path links.

/, /imprint, /privacy, /terms, /out/, /nutzung