wordexpress-components
v2.0.1
Published
A Set of Components for use with WordExpress
Downloads
18
Maintainers
Readme
WordExpress Components
This package contains useful components for WordExpress. The components contain GraphQL queries that return data from a WordPress database, using ApolloStack to fetch the data.
For a full example of how these components work, check out the repo for WordExpress.io, which was built using some of these components.
Components
WordExpressPage
This is a component used to render a WordPress page. It's probably mostly used as a the component to render on a React Router route. In WordExpress, this is how it's being used:
...
import Layouts from './components/layouts/layouts.js';
import { WordExpressPage } from 'wordexpress-components';
let routes = (
<Route path="/" component={App} Layouts={Layouts}>
<IndexRoute component={WordExpressPage}/>
<Route path=":page" component={WordExpressPage}/>
</Route>
);
...
Above, the Layouts component is a mapped object that return a Layout Component based on a custom field in your WordPress backend. The details of how Layouts work is explained here. WordExpressPage contains a query which fetchs the Page based on its slug and gets the layout value. It also gets things like Post Title and Post Content as well. Refer to the source for more details.
WordExpressPage passes the returned Page data to it's Layout. It can be accessed like this:
class DefaultLayout extends Component {
static propTypes = {
page: PropTypes.object
}
render() {
const { loading } = this.props.page;
if (!loading) {
const { post_title: title, post_content: content, thumbnail } = this.props.page;
const bg = {backgroundImage: `url("${thumbnail}")`};
const heroClass = thumbnail ? 'hero_thumbnail' : 'hero';
return (
<Page>
<div styleName={heroClass} style={bg}>
<div styleName="wrapper tight">
<h2 styleName="title">{title}</h2>
</div>
</div>
<div styleName="content">
<div styleName="wrapper tight">
<PostContent content={content}/>
</div>
</div>
</Page>
);
}
return <div></div>;
}
}
WordExpressMenu
This components fetchs a menu based on its slug and returns all of its items and links. Its used in WordExpress like this:
...
import { WordExpressMenu } from 'wordexpress-components';
...
class Header extends React.Component{
render(){
return (
<header styleName="base">
<div styleName="wrapper">
<WordExpressMenu menu="primary-navigation">
<AppNav/>
</WordExpressMenu>
</div>
</header>
)
}
}
Note that WordExpressMenu takes a prop called menu. This should be the slug of your WordPress menu. In the above example, AppNav has access to the Menu items.
...
import {sortBy} from 'lodash';
...
class AppNav extends Component {
static propTypes = {
menu: PropTypes.object
}
render() {
if (!this.props.menu) {
return null;
}
let { items } = this.props.menu;
items = sortBy(items, 'order');
return (
<NavList type="primary">
<NavItem>
<Link to="/"><Logo/></Link>
</NavItem>
{items.map( item => {
const {children, object_type: type, post_title: title} = item;
const linkText = title.length > 0 ? title : item.navitem.post_title;
const pathname = type === 'page' ? `/${item.navitem.post_name}` : `/${type}/${item.navitem.post_name}`;
return (
<NavItem key={item.id}>
<Link to={{ pathname: pathname }} className={styles.link}>{linkText}</Link>
{children.length > 0 &&
<NavList type="subnav">
{children.map( child => {
return (
<NavItem type="link" href="{child.navitem.post_name}">{child.navitem.post_title}</NavItem>
);
})}
</NavList>
}
</NavItem>
);
})}
</NavList>
);
}
}
In the above example, this will work for subnav items in your menu as well!