An easy way to integrate your react application with the world's most popular content management system. wp-react-lib uses the Wordpress REST API to load content into your classic React.js stack, it also allows embedding your own React.js components within pages and posts.

[email protected] uses Redux and Immutable , you need to configure your store as the following example:

import {applyMiddleware, compose, createStore} from 'redux'  
import {combineReducers} from 'redux-immutable';  
import {Map} from 'immutable'  
import thunk from 'redux-thunk'  
import {wordpress} from "wp-react-lib";

const initialState = Map()  
const getRootReducer = () => combineReducers({  
  wordpress,  
})  
const store = createStore(  
  getRootReducer(), // root reducer with router state      
  initialState,  
  compose(applyMiddleware(thunk))  
)

• Run dev_services.sh to start docker container using development enviroment
• Open localhost
• Follow WordPress setup wizard
  • Go to settings/permalinks, then choose day and name
    • This configuration depends of your react routes setup
  • Go to appearance/themes and activate wp-react-theme
    • By activating this theme WordPress will disable its front-end
  • Go to plugins and activate the following plugins
    • WP Multilang
    • WP-REST-API V2 Menus
    • WP React Lib Components
• Update .env file accordingly
• run npm install
• run npm start

 <Provider store={store}>  
     <div className="App">  
	  <PageProvider slug={"home"}>  
		  <PageConsumer> 
			 <Page/> 
		  </PageConsumer> 
	  </PageProvider> 
     </div>
 </Provider>

 <Provider store={store}>        
    <div className="App">    
       <PostProvider slug={"my-post-slug"}>    
          <PostConsumer>   
             <Post/>   
          </PostConsumer>   
       </PostProvider>   
    </div>  
 </Provider>  

 const List = ({posts}) => {        
   return 
     <ul>  
       {posts.map(post =>(<li> <h1 dangerouslySetInnerHTML={{__html: post.title.rendered}}/> </li>))} 
 </ul>
 }    
         
    function ShowPosts() {    
            return (    
            <Provider store={store}>    
              <div className="App">    
                 <PostProvider>    
                   <PostConsumer> 
		   <List></List>   
                   </PostConsumer>   
                 </PostProvider>   
              </div>   
           </Provider> );    
	}  

• type: You can specify your custom post type.
• taxonomy: Taxonomy used for filtering posts, categories is used by default.
• categories: Array of categories ids for filtering the post by the taxonomy.
• before : ISO date used to filter posts by date before
• perPage: Number of post loaded per page
• page: Number of page that has to be returned.
• fields: Specify which field will be returned in the post object.
• slug: Filter by post slug.
• store: Specify the immutable path where returned posts will be stored, useful when having multiple components loading different posts
• locale: Specify the post language (multiLang plugin required)

Using router for loading pages

<Route exact path="/:slug" render={(props)=>{  
    return (<div className="App">  
		     <PageProvider slug={props.match.params.slug}>  
			     <PageConsumer> 
				     <Page></Page> 
			     </PageConsumer> 
		     </PageProvider> 
	     </div>
}}>  
</Route>

Using router for loading posts

<Route path="/:lan/:year/:month/:day/:slug/" exact render=
    {props => (  
         <PostProvider  slug={props.match.params.slug} >  
	     <PostConsumer> 
		     <Post></Post> 
	     </PostConsumer> 
     </PostProvider> 
 )}>  
</Route>

You can create and embed your own React components in WordPress editor, configure them, save its metadata, and render them in your React UI as part of your react application.

To create an embeddable component you need

• Create your React component
• Add a route that exposes your component without your ui layout
• Create a wordpress plugin that wraps your component and put it available as a wordpress block.
• Login in wordpress admin site, go to settings > WP React Settings and enter React APP base URL

Please look at wp-react-example-advanced and wp-react-blocks-plugin

For details about how to send pull requests, please read CONTRIBUTING.md.

• Sebastian Dimunzio - Architecture and code - sdimunzio

The list of all contributors to this project can be read at contributors.

This project is under - Apache License 2.0 - for more details please check Apache License 2.0

For any comments or suggestions, please contact us