Beskrywing
Easily create, build and deploy React apps into your existing WordPress sites.
Get started in seconds and develop your React app with instant feedback and your WordPress theme in mind.
Combine the flexibility of WordPress with the UI capabilities of React and seamlessly integrate create-react-app into your WordPress project for your next SaaS.
ReactPress does 3 things:
- It integrates your local dev server into your WordPress theme, that you have instant feedback, how your React app looks in the context of your WordPress website.
- It builds your React app in a way that it is usable from your WordPress site.
- It makes it easy to upload your app to a live server after building.
System Requirements
To develop React apps your WordPress instance needs access to:
-
the PHP function
shell_exec
andexec
, -
and a POSIX compatible system (Windows users can use WSL2).
Optionally, to create React apps directly from the WordPress admin it needs also:
- the nodejs package manager
npm
version 6 or higher
Development
Active development of this plugin is handled on GitHub.
Documentation
If you need more information than the following, you can have a look at the Documentation page.
To create and deploy your first app:
-
Install ReactPress on your local WordPress installation.
-
In your command line use npx create-react-app [your-app-name] in the apps directory of ReactPress, e.g.
[path-to-WordPress]/wp-content/reactpress/apps/my-app
-
Reload the ReactPress admin page and add a URL Slug for your app.
-
In the command line start the React app with
npm start
oryarn start
. -
Develop your app, changes will automatically hot reloaded.
-
When you are finished, build the app from the command line. You can now see your app embedded in your WordPress instance. Open it at [your-domain]/[your-slug].
-
To deploy, Install ReactPress on live WordPress site.
-
Upload the build folder from your dev system under
.../wp-content/reactpress/apps/[your-app-name]
to the same directory onto your live server. No need for create-react-app. -
Reload the ReactPress admin page and add a URL Slug for your app.
-
Open the React app under [your-domain]/[your-slug].
Repeat steps 6 to 10 when you have new releases you want to deploy.
Screenshots
Create a new React app for development called reactino.
The new React app is created and running.
The local React dev server is running on port: 3000. Every change will hot reload immediately.
Create a new React app for deployment on the server.
The new React app is created, but no dev server is running.
The React app is deployed on the public server.
Installation
-
Like any other plugin install via Plugins/Add New. You can download the plugin via admin or upload it to the plugins directory.
-
Activate the plugin through the ‘Plugins’ menu in WordPress
Kwel-vrae
-
How do I make react-router work
-
To make sure that react-router works you have to go to your WP permalink setting and click on save chang after every react app you install. This will rebuild the internal router of your WP installation.
Aanbevelings
Contributors & Developers
“ReactPress – Create React App for WordPress” is oopbron sagteware. Die volgende mense het bygedra tot die ontwikkeling van hierdie uitbreiding:
ContributorsTranslate “ReactPress – Create React App for WordPress” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.3.2
-
Swap file_get_contents for wp_remote_get.
-
Create custom routing for react-router based on slug of the reactpress page.
-
If the folder of an app is deleted, it is shown as type: Orphan
1.3.0
-
Move apps directory to wp-content/reactpress/apps to don’t mess with the created app when updating the plugin.
-
Remove possibility to create new react apps from the admin. From now on there is only the command line workflow.
1.2.1
-
FIX: Template incompatibility with Elementor and some other plugins. Thank to the great answer of Sally CJ https://stackoverflow.com/questions/67696139/error-in-wordpress-with-plugin-reactpress/68455647#answer-67751220
-
FIX: Problems if document root and plugin app directory are on the same machine/server/locationn
1.2.0
-
Revamp the process of adding using ReactPress. Don’t start the react app anymore, only update the
index.html
from WordPress admin. Make it possible to add apps manually with npm or yarn. -
Add fallback if we can’t find the plugin directory programmatically.
1.1.0
-
Test with WordPress 5.7
-
Insert the current user object to the global window object in Javascript, to have it accessible without a call to the API.
-
add .env with CHOKIDAR_USEPOLLING=true to ensure watcher works with VM
-
Use npm instead of yarn.
1.0.0
-
Check for if it allows
shell_exec
andexec
-
npm -v >= 6.0.0
is reachable from WordPress -
Find out if we are in a Windows environment
-
Deploy app to production
-
Add TypeScript/template support
-
Delete app
-
Build app
-
Extend index.html in React app to look like WordPress site
-
Create new React app
-
Add React app in specified page