How to Integrate Bolt.new with Joomla

1# .env — add to project root
2JOOMLA_API_URL=https://yoursite.com
3JOOMLA_API_TOKEN=your_joomla_api_token_here
4
5# Verify API is enabled by opening in browser:
6# https://yoursite.com/api/index.php/v1/content/articles
7# With token: curl -H 'Authorization: Bearer YOUR_TOKEN' https://yoursite.com/api/index.php/v1/content/articles

1// app/api/joomla/articles/route.ts
2import { NextRequest, NextResponse } from 'next/server';
3
4interface JoomlaArticleAttributes {
5  title: string;
6  alias: string;
7  introtext: string;
8  fulltext: string;
9  catid: number;
10  publish_up: string;
11  images: string;
12  state: number;
13}
14
15interface JoomlaAPIItem {
16  id: string;
17  attributes: JoomlaArticleAttributes;
18}
19
20interface JoomlaAPIResponse {
21  data: JoomlaAPIItem[];
22  meta?: { 'total-pages'?: number };
23  links?: { self: string; next?: string };
24}
25
26export async function GET(request: NextRequest) {
27  const apiUrl = process.env.JOOMLA_API_URL;
28  const apiToken = process.env.JOOMLA_API_TOKEN;
29
30  if (!apiUrl || !apiToken) {
31    return NextResponse.json(
32      { error: 'JOOMLA_API_URL and JOOMLA_API_TOKEN must be configured' },
33      { status: 500 }
34    );
35  }
36
37  const { searchParams } = new URL(request.url);
38  const limit = searchParams.get('limit') || '10';
39  const offset = searchParams.get('offset') || '0';
40  const catid = searchParams.get('catid');
41
42  const url = new URL(`${apiUrl}/api/index.php/v1/content/articles`);
43  url.searchParams.set('page[limit]', limit);
44  url.searchParams.set('page[offset]', offset);
45  if (catid) url.searchParams.set('filter[category_id]', catid);
46
47  try {
48    const response = await fetch(url.toString(), {
49      headers: {
50        'Authorization': `Bearer ${apiToken}`,
51        'Accept': 'application/vnd.api+json',
52        'Content-Type': 'application/json',
53      },
54    });
55
56    if (!response.ok) {
57      return NextResponse.json(
58        { error: `Joomla API error: ${response.status} ${response.statusText}` },
59        { status: response.status }
60      );
61    }
62
63    const data: JoomlaAPIResponse = await response.json();
64
65    const articles = (data.data || []).map((item) => {
66      const attr = item.attributes;
67      let images: Record<string, string> = {};
68      try {
69        images = JSON.parse(attr.images || '{}');
70      } catch {
71        images = {};
72      }
73
74      return {
75        id: item.id,
76        title: attr.title,
77        slug: attr.alias,
78        introtext: attr.introtext,
79        fulltext: attr.fulltext,
80        catid: attr.catid,
81        publishDate: attr.publish_up,
82        introImage: images.image_intro || null,
83        fullImage: images.image_fulltext || null,
84      };
85    });
86
87    return NextResponse.json({
88      articles,
89      total: data.meta?.['total-pages'] || null,
90    });
91  } catch (error) {
92    const message = error instanceof Error ? error.message : 'Unknown error';
93    return NextResponse.json({ error: message }, { status: 500 });
94  }
95}

1// app/api/joomla/articles/[slug]/route.ts
2import { NextResponse } from 'next/server';
3
4export async function GET(
5  _request: Request,
6  { params }: { params: { slug: string } }
7) {
8  const apiUrl = process.env.JOOMLA_API_URL;
9  const apiToken = process.env.JOOMLA_API_TOKEN;
10
11  if (!apiUrl || !apiToken) {
12    return NextResponse.json(
13      { error: 'Joomla API credentials not configured' },
14      { status: 500 }
15    );
16  }
17
18  const url = new URL(`${apiUrl}/api/index.php/v1/content/articles`);
19  url.searchParams.set('filter[alias]', params.slug);
20
21  try {
22    const response = await fetch(url.toString(), {
23      headers: {
24        'Authorization': `Bearer ${apiToken}`,
25        'Accept': 'application/vnd.api+json',
26      },
27    });
28
29    if (!response.ok) {
30      return NextResponse.json(
31        { error: `Joomla API error: ${response.status}` },
32        { status: response.status }
33      );
34    }
35
36    const data = await response.json();
37    const items = data.data || [];
38
39    if (items.length === 0) {
40      return NextResponse.json({ error: 'Article not found' }, { status: 404 });
41    }
42
43    const attr = items[0].attributes;
44    let images: Record<string, string> = {};
45    try { images = JSON.parse(attr.images || '{}'); } catch { images = {}; }
46
47    const article = {
48      id: items[0].id,
49      title: attr.title,
50      slug: attr.alias,
51      introtext: attr.introtext,
52      fulltext: attr.fulltext,
53      content: [attr.introtext, attr.fulltext].filter(Boolean).join('\n'),
54      catid: attr.catid,
55      publishDate: attr.publish_up,
56      introImage: images.image_intro || null,
57      fullImage: images.image_fulltext || null,
58    };
59
60    return NextResponse.json({ article });
61  } catch (error) {
62    const message = error instanceof Error ? error.message : 'Unknown error';
63    return NextResponse.json({ error: message }, { status: 500 });
64  }
65}

1// app/api/joomla/categories/route.ts
2import { NextResponse } from 'next/server';
3
4export async function GET() {
5  const apiUrl = process.env.JOOMLA_API_URL;
6  const apiToken = process.env.JOOMLA_API_TOKEN;
7
8  if (!apiUrl || !apiToken) {
9    return NextResponse.json(
10      { error: 'Joomla API credentials not configured' },
11      { status: 500 }
12    );
13  }
14
15  const url = new URL(`${apiUrl}/api/index.php/v1/categories`);
16  url.searchParams.set('component', 'com_content');
17  url.searchParams.set('page[limit]', '50');
18
19  try {
20    const response = await fetch(url.toString(), {
21      headers: {
22        'Authorization': `Bearer ${apiToken}`,
23        'Accept': 'application/vnd.api+json',
24      },
25    });
26
27    if (!response.ok) {
28      return NextResponse.json(
29        { error: `Joomla Categories API error: ${response.status}` },
30        { status: response.status }
31      );
32    }
33
34    const data = await response.json();
35    const categories = (data.data || []).map((item: { id: string; attributes: { title: string; alias: string; parent_id: number; level: number; description: string } }) => ({
36      id: item.id,
37      title: item.attributes.title,
38      alias: item.attributes.alias,
39      parentId: item.attributes.parent_id,
40      level: item.attributes.level,
41      description: item.attributes.description,
42    }));
43
44    return NextResponse.json({ categories });
45  } catch (error) {
46    const message = error instanceof Error ? error.message : 'Unknown error';
47    return NextResponse.json({ error: message }, { status: 500 });
48  }
49}

1// app/api/joomla/revalidate/route.ts
2import { NextResponse } from 'next/server';
3import { revalidatePath } from 'next/cache';
4
5export async function POST(request: Request) {
6  const secret = request.headers.get('x-revalidate-secret');
7
8  if (!secret || secret !== process.env.JOOMLA_REVALIDATE_SECRET) {
9    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
10  }
11
12  try {
13    const body = await request.json();
14    const alias = body?.alias as string | undefined;
15
16    revalidatePath('/blog');
17
18    if (alias) {
19      revalidatePath(`/blog/${alias}`);
20    }
21
22    return NextResponse.json({
23      revalidated: true,
24      paths: alias ? ['/blog', `/blog/${alias}`] : ['/blog'],
25    });
26  } catch {
27    return NextResponse.json({ error: 'Revalidation failed' }, { status: 500 });
28  }
29}