Build amazing iOS and Android applications for your WordPress website for free!
JavaScript CSS HTML CoffeeScript Shell

README.md

WordPress Hybrid Client

Flattr donate button PayPal donate button

screenshots

Chat

Join the chat at https://gitter.im/shprink/wordpress-hybrid-client

Features

  • Posts
  • Pages
  • Custom posts
  • Taxonomies (Category, Tag and custom)
  • Authors
  • Search
  • Push Notifications
  • Custom templates (overwrite any template of the app)
  • Social sharing
  • Admob support
  • Sass variables
  • Parameters Page
    • Language switch [English|French|Chinese|Spanish|Polish|German|Portuguese|Italian|Dutch|Russian|Turkish|Urdu]
    • Accessibility (Post font size)
  • Image cache on device
  • App rate plugin
  • Syntax highlighter
  • Offline (Bookmarks)
  • Comments (Submitting is not supported yet)
  • Progressive Web App (manifest & Service Workers)

Built with WPHC

Quick Start

Prerequisites

  • Git
  • NodeJS (>= 4)
  • NPM (>= 3)
  • Yarn

This installation works on both OSX and Linux. Windows is not supported yet,

# Clone and use the latest version
$ git clone https://github.com/shprink/wordpress-hybrid-client.git && cd wordpress-hybrid-client
# List all versions
$ git tag
$ git checkout <the-latest-version>

# Install
$ yarn

# Run on the browser
$ npm start

Open http://localhost:8080/webpack-dev-server/ in Chrome (the only browser supported). You should see the application running with http://dev.julienrenaux.fr/wp-json backend.

To go further please read the documentations.

Documentation

If you have just cloned the repository, INSTALLATION is the recommended starting point. Here is the documentation index:

Installation

Read the manual: INSTALLATION.md

Configuration

Read the manual: CONFIGURATION.md

Development

Read the manual: DEVELOPMENT.md

Push Notifications

Read the manual: PUSHNOTIFICATIONS.md

Build Android & iOS

Read the manual: BUILD.md

Release Android & iOS

Read the manual: RELEASE.md

Splashscreens and Icons

Read the manual: SPLASHICONS.md

Project public API

# Installation
npm run installWPHC (auto ran post npm install)

# Dev server
npm start

# Dump files in www
npm run dumpdev
npm run dumpprod

# Install Cordova
npm run restore

# Run Cordova
npm run android
npm run ios
npm run iosEmulator

# Cordova build
npm run buildAndroid
npm run buildProdAndroid
npm run buildIOS
npm run buildProdIOS

Contribute

WordPress hybrid Client is Open Source, If you are interested in helping, please read the following:

Pull Request Guidelines

When in doubt, keep your pull requests small. To give a PR the best chance of getting accepted, do not bundle more than one "feature" or bug fix in one PR. Doing so makes it very hard to accept it if one of the fixes has issues.

It's always best to create two smaller PRs than one big one.

Style

Follow .editconfig