magnolia-react-templating
Advanced tools
Use React JSX Components in Magnolia templates (e.g. Freemarker).
This small utility allows you to use React JSX components directly in Magnolia templates (e.g. Freemarker).
To get started, you should set up a frontend project with npx create-react-app.
The main entry point for your application is src/index.js. Please remove the default content and replace it with the content below. This file registers all React components which you want to use within Magnolia templates.
import { render } from "magnolia-react-templating";
import "./index.css";
import Layout from "./components/Layout";
import Headline from "./components/Headline";
import Text from "./components/Text";
import Image from "./components/Image";
render({ Layout, Headline, Text, Image }, document.getElementById("root"));
Now adapt your page template in Magnolia (e.g. backend/light-modules/react-demo/templates/pages/ContentPage.ftl), so the React bundle is loaded into your page. Here's an example:
<!DOCTYPE html>
<html>
<head>
[@cms.page /]
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>${content.windowTitle!content.title!}</title>
</head>
<body>
[#-- Create a root container for React. --]
<div id="root">
[#-- Put JSX into a script-tag below the root --]
<script type="text/jsx">
<Layout>
[@cms.area name="main"/]
</Layout>
</script>
</div>
<script src="http://localhost:3000/static/js/bundle.js"></script>
<script src="http://localhost:3000/static/js/0.chunk.js"></script>
<script src="http://localhost:3000/static/js/1.chunk.js"></script>
<script src="http://localhost:3000/static/js/main.chunk.js"></script>
</body>
</html>
And here is an example on how to wire up a Freemarker template with JSX code (e.g. backend/light-modules/react-demo/templates/components/Image.ftl):
[#assign image = damfn.getAsset(content.image)]
[#assign imageLink = image.link]
<Image
url="${imageLink}"
alt="${content.caption!'image'}"
rounded={${(content.rounded!false)?c}}
/>
The corresponding React component looks like this (e.g. frontend/src/components/Image.js):
import React from "react";
export default Image({ url, alt, rounded })(
<figure>
<img className={rounded ? "is-rounded" : ""} src={url} alt={alt} />
</figure>
);
FAQs
Use React JSX Components in Magnolia templates (e.g. Freemarker).
The npm package magnolia-react-templating receives a total of 45 weekly downloads. As such, magnolia-react-templating popularity was classified as not popular.
We found that magnolia-react-templating demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."