Skip to content

Latest commit

 

History

History
172 lines (124 loc) · 5.64 KB

README.md

File metadata and controls

172 lines (124 loc) · 5.64 KB

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