Skip to content

Commit 8825e56

Browse files
GrabauskasGrabauskas
authored
feat: Feeds Changelog Buttons & SEO Improvements (#114)
1 parent afd13dd commit 8825e56

File tree

6 files changed

+199
-16
lines changed

6 files changed

+199
-16
lines changed

‎docusaurus.config.ts‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -230,7 +230,8 @@ const config: Config = {
230230
feedOptions: {
231231
type: "all",
232232
title: "OneGround ZGW API Changelog",
233-
description: "Latest releases and updates for OneGround ZGW API platform"
233+
description: "Latest releases and updates for OneGround ZGW API platform",
234+
xslt: true
234235
}
235236
} satisfies PluginContentBlog.Options
236237
],

‎src/components/ChangelogFeedLinks/index.tsx‎

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
import React, { type ReactNode } from "react";
2+
import Link from "@docusaurus/Link";
3+
import styles from "./styles.module.css";
4+
5+
const RSS_ATOM_PATH =
6+
"M6.503 20.752c0 1.794-1.456 3.248-3.251 3.248-1.796 0-3.252-1.454-3.252-3.248 0-1.794 1.456-3.248 3.252-3.248 1.795.001 3.251 1.454 3.251 3.248zm-6.503-12.572v4.811c6.05.062 10.96 4.966 11.022 11.009h4.817c-.062-8.71-7.118-15.758-15.839-15.82zm0-3.368c10.58.046 19.152 8.594 19.183 19.188h4.817c-.03-13.231-10.755-23.954-24-24v4.812z";
7+
8+
const JSON_PATH = "M9.4 16.6L4.8 12l4.6-4.6L8 6l-6 6 6 6 1.4-1.4zm5.2 0l4.6-4.6-4.6-4.6L16 6l6 6-6 6-1.4-1.4z";
9+
10+
function FeedIcon({ color, path }: { color: string; path: string }): ReactNode {
11+
return (
12+
<svg
13+
xmlns="http://www.w3.org/2000/svg"
14+
viewBox="0 0 24 24"
15+
width="16"
16+
height="16"
17+
style={{ fill: color, flexShrink: 0 }}
18+
aria-hidden="true"
19+
>
20+
<path d={path} />
21+
</svg>
22+
);
23+
}
24+
25+
export default function ChangelogFeedLinks(): ReactNode {
26+
return (
27+
<div className={styles.feedContainer}>
28+
<Link
29+
href="pathname:///changelog/rss.xml"
30+
className={styles.feedLink}
31+
style={{ "--feed-accent": "#f26522" } as React.CSSProperties}
32+
>
33+
<FeedIcon color="#f26522" path={RSS_ATOM_PATH} />
34+
<span>RSS</span>
35+
</Link>
36+
<Link
37+
href="pathname:///changelog/atom.xml"
38+
className={styles.feedLink}
39+
style={{ "--feed-accent": "#4caf50" } as React.CSSProperties}
40+
>
41+
<FeedIcon color="#4caf50" path={RSS_ATOM_PATH} />
42+
<span>Atom</span>
43+
</Link>
44+
<Link
45+
href="pathname:///changelog/feed.json"
46+
className={styles.feedLink}
47+
style={{ "--feed-accent": "#2196f3" } as React.CSSProperties}
48+
>
49+
<FeedIcon color="#2196f3" path={JSON_PATH} />
50+
<span>JSON</span>
51+
</Link>
52+
</div>
53+
);
54+
}

‎src/components/ChangelogFeedLinks/styles.module.css‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
.feedContainer {
2+
display: flex;
3+
gap: 1rem;
4+
flex-wrap: wrap;
5+
margin-bottom: 1rem;
6+
align-items: center;
7+
}
8+
9+
.feedLink {
10+
display: inline-flex;
11+
align-items: center;
12+
gap: 0.35rem;
13+
border-radius: 2rem;
14+
padding: 0.3rem 0.85rem;
15+
font-weight: 600;
16+
font-size: 0.8rem;
17+
color: var(--feed-accent);
18+
background: color-mix(in srgb, var(--feed-accent) 10%, transparent);
19+
transition: background-color 0.2s ease;
20+
text-decoration: none;
21+
}
22+
23+
.feedLink:hover {
24+
background: color-mix(in srgb, var(--feed-accent) 20%, transparent);
25+
text-decoration: none;
26+
color: var(--feed-accent);
27+
}
28+
29+
[data-theme="dark"] .feedLink {
30+
background: color-mix(in srgb, var(--feed-accent) 15%, transparent);
31+
}
32+
33+
[data-theme="dark"] .feedLink:hover {
34+
background: color-mix(in srgb, var(--feed-accent) 25%, transparent);
35+
}

‎src/theme/BlogListPage/index.tsx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
import React, { type ReactNode } from "react";
2+
import BlogListPage from "@theme-original/BlogListPage";
3+
import type { Props } from "@theme/BlogListPage";
4+
5+
export default function BlogListPageWrapper(props: Props): ReactNode {
6+
return <BlogListPage {...props} />;
7+
}

‎src/theme/BlogPostItems/index.tsx‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
import React, { type ReactNode } from "react";
2+
import { useLocation } from "@docusaurus/router";
3+
import BlogPostItems from "@theme-original/BlogPostItems";
4+
import type { Props } from "@theme/BlogPostItems";
5+
import ChangelogFeedLinks from "@site/src/components/ChangelogFeedLinks";
6+
7+
export default function BlogPostItemsWrapper(props: Props): ReactNode {
8+
const { pathname } = useLocation();
9+
const isChangelog = pathname.startsWith("/changelog");
10+
11+
return (
12+
<>
13+
{isChangelog && <ChangelogFeedLinks />}
14+
<BlogPostItems {...props} />
15+
</>
16+
);
17+
}

‎static/structured-data.json‎

Lines changed: 84 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,16 @@
77
"name": "OneGround",
88
"alternateName": "Roxit OneGround",
99
"url": "https://dev.oneground.nl",
10-
"sameAs": ["https://github.com/OneGround", "https://oneground.nl", "https://portaal.oneground.nl"],
10+
"sameAs": [
11+
"https://github.com/OneGround",
12+
"https://oneground.nl",
13+
"https://portaal.oneground.nl",
14+
"https://www.linkedin.com/showcase/one-ground/",
15+
"https://www.youtube.com/@vismaroxit"
16+
],
1117
"logo": {
1218
"@type": "ImageObject",
13-
"url": "https://dev.oneground.nl/img/logo.png",
19+
"url": "https://dev.oneground.nl/img/logo.svg",
1420
"width": 200,
1521
"height": 60
1622
},
@@ -47,15 +53,7 @@
4753
"publisher": {
4854
"@id": "https://dev.oneground.nl/#organization"
4955
},
50-
"inLanguage": "en",
51-
"potentialAction": {
52-
"@type": "SearchAction",
53-
"target": {
54-
"@type": "EntryPoint",
55-
"urlTemplate": "https://dev.oneground.nl/search?q={search_term_string}"
56-
},
57-
"query-input": "required name=search_term_string"
58-
}
56+
"inLanguage": "en"
5957
},
6058
{
6159
"@type": "SoftwareApplication",
@@ -128,7 +126,7 @@
128126
"description": "OneGround is a comprehensive implementation of Dutch ZGW APIs for case management (Zaakgericht Werken). Learn about ZRC, DRC, ZTC, BRC, NRC, AC components, features, and how to get started.",
129127
"url": "https://dev.oneground.nl/docs/about-oneground",
130128
"datePublished": "2024-01-01",
131-
"dateModified": "2025-06-09",
129+
"dateModified": "2026-01-19",
132130
"author": {
133131
"@id": "https://dev.oneground.nl/#organization"
134132
},
@@ -152,6 +150,13 @@
152150
"NRC",
153151
"AC",
154152
"RL",
153+
"OAuth2",
154+
"JWT",
155+
"Docker",
156+
".NET",
157+
"webhooks",
158+
"digital signing",
159+
"NEN-ISO 16175",
155160
"VNG standards",
156161
"government APIs"
157162
]
@@ -167,6 +172,60 @@
167172
},
168173
"inLanguage": "en"
169174
},
175+
{
176+
"@type": "BlogPosting",
177+
"@id": "https://dev.oneground.nl/blog/best-practices-for-jwt-usage-in-apis#blogposting",
178+
"headline": "Best Practices for JWT Usage in APIs - OneGround Security Guide",
179+
"description": "Comprehensive guide to implementing JWT authentication securely in ZGW APIs and OneGround. Learn about token security, validation, best practices, and common pitfalls to avoid.",
180+
"url": "https://dev.oneground.nl/blog/best-practices-for-jwt-usage-in-apis",
181+
"datePublished": "2024-12-03",
182+
"author": {
183+
"@type": "Person",
184+
"name": "Giedrius Grabauskas"
185+
},
186+
"isPartOf": {
187+
"@id": "https://dev.oneground.nl/blog#blog"
188+
},
189+
"publisher": {
190+
"@id": "https://dev.oneground.nl/#organization"
191+
}
192+
},
193+
{
194+
"@type": "BlogPosting",
195+
"@id": "https://dev.oneground.nl/blog/integrating-signing-software-with-zgw#blogposting",
196+
"headline": "Standardized Document Signing Integration for ZGW APIs - Complete Guide",
197+
"description": "Learn how to integrate digital document signing software with ZGW APIs. Complete implementation guide with API patterns, authentication methods, and standardized trigger messages for OneGround and compliant ZGW systems.",
198+
"url": "https://dev.oneground.nl/blog/integrating-signing-software-with-zgw",
199+
"datePublished": "2025-03-27",
200+
"author": {
201+
"@type": "Person",
202+
"name": "Michiel Nijdam"
203+
},
204+
"isPartOf": {
205+
"@id": "https://dev.oneground.nl/blog#blog"
206+
},
207+
"publisher": {
208+
"@id": "https://dev.oneground.nl/#organization"
209+
}
210+
},
211+
{
212+
"@type": "BlogPosting",
213+
"@id": "https://dev.oneground.nl/blog/oauth2-token-endpoint#blogposting",
214+
"headline": "Why OneGround Uses an OAuth2 Token Endpoint",
215+
"description": "Learn why customer-generated JWTs are risky and how OAuth2 Token Endpoints provide better security, control, and simplicity for API authentication.",
216+
"url": "https://dev.oneground.nl/blog/oauth2-token-endpoint",
217+
"datePublished": "2025-11-14",
218+
"author": {
219+
"@type": "Person",
220+
"name": "Giedrius Grabauskas"
221+
},
222+
"isPartOf": {
223+
"@id": "https://dev.oneground.nl/blog#blog"
224+
},
225+
"publisher": {
226+
"@id": "https://dev.oneground.nl/#organization"
227+
}
228+
},
170229
{
171230
"@type": "FAQPage",
172231
"@id": "https://dev.oneground.nl/#faq",
@@ -176,7 +235,7 @@
176235
"name": "What is OneGround?",
177236
"acceptedAnswer": {
178237
"@type": "Answer",
179-
"text": "OneGround is the implementation by Roxit of case oriented APIs and registrations according to the VNG specifications. It contains ZTC, ZRC, DRC, BRC, NC, AC and reference lists for Dutch government case management."
238+
"text": "OneGround is the implementation by Roxit of case oriented APIs and registrations according to the VNG specifications. It contains ZTC, ZRC, DRC, BRC, NRC, AC and reference lists for Dutch government case management."
180239
}
181240
},
182241
{
@@ -192,7 +251,7 @@
192251
"name": "What ZGW components does OneGround include?",
193252
"acceptedAnswer": {
194253
"@type": "Answer",
195-
"text": "OneGround includes all ZGW API components: ZRC (Case Registration), DRC (Document Registration), ZTC (Case Type Catalog), BRC (Decision Registration), NRC (Notification Center), and AC (Authorization Component)."
254+
"text": "OneGround includes all ZGW API components: ZRC (Case Registration), DRC (Document Registration), ZTC (Case Type Catalog), BRC (Decision Registration), NRC (Notification Center), AC (Authorization Component), and RL (Reference Lists)."
196255
}
197256
},
198257
{
@@ -244,7 +303,17 @@
244303
"creator": {
245304
"@id": "https://dev.oneground.nl/#organization"
246305
},
247-
"keywords": ["ZGW API", "Documentation", "Dutch Government", "Case Management", "API Reference"],
306+
"keywords": [
307+
"ZGW API",
308+
"Documentation",
309+
"Dutch Government",
310+
"Case Management",
311+
"API Reference",
312+
"OAuth2",
313+
"JWT",
314+
"webhooks",
315+
"integration guides"
316+
],
248317
"license": "https://github.com/OneGround/oneground.github.io/blob/main/LICENSE",
249318
"distribution": {
250319
"@type": "DataDownload",

0 commit comments

Comments
 (0)