A reusable iOS rich text editor component.
JavaScript Objective-C CSS Other
Latest commit 4ddd483 Feb 22, 2017 @koke koke committed on GitHub Merge pull request #876 from wordpress-mobile/1.9.0
1.9.0 Release

README.md

Build Status

WordPress Logo

WordPress-Editor-iOS

WordPress-iOS-Editor ScreenshotWordPress-iOS-Editor Screenshot 2WordPress-iOS-Editor Screenshot 3

Introduction

The WordPress-Editor-iOS is the text editor used in the WordPress iOS app to create and edit pages & posts. In short it's a simple, straightforward way to visually edit HTML.

How to get started

You can install the editor in your app via CocoaPods:

platform :ios, '9.0'
pod 'WordPress-iOS-Editor'

Or, you can just try out the demo by using the CocoaPods try command:

pod try WordPress-iOS-Editor

Requirements

WordPress-iOS-Editor requires iOS 9.0 or higher. It depends on the following Apple frameworks:

  • Foundation.framework
  • UIKit.framework
  • CoreGraphics.framework
  • CoreText.framework

and the following CocoaPods:

See the podspec for more details.

Usage

There are three things that you need to do in order to use the WordPress-iOS-Editor in your app.

  1. Create a ViewController that extends WPEditorViewController

    #import <UIKit/UIKit.h>
    #import <WordPress-iOS-Editor/WPEditorViewController.h>
    
    @interface WPViewController : WPEditorViewController <WPEditorViewControllerDelegate>
    
    @end
    
  2. Implement any of the optional WPEditorViewControllerDelegate methods in your view controller.

  3. The titleText and bodyText properties can be used to set and get the title and body of the text document.

For more details, you can review the EditorDemo project included in this repo.

Other Resources

Developer blog & Handbook

Blog: http://make.wordpress.org/mobile

Handbook: http://make.wordpress.org/mobile/handbook

Style guide

https://github.com/wordpress-mobile/WordPress-iOS/wiki/WordPress-for-iOS-Style-Guide

To report an issue (for the editor only)

https://github.com/wordpress-mobile/WordPress-iOS-Editor/issues

Source Code

GitHub: https://github.com/wordpress-mobile/WordPress-iOS-Editor

How to Contribute

http://make.wordpress.org/mobile/handbook/pathways/ios/how-to-contribute

Attribution

The following projects were used in the WordPress-iOS-Editor codebase:

Component Description License
ZSSRichTextEditor ZSSRichTextEditor is a rich text WYSIWYG Editor for iOS and was the basis for this project. MIT
CYRTextView CYRTextView is a UITextView subclass that implements a variety of features that are relevant to a syntax or code text view. MIT
HRColorPicker Simple color picker for iPhone BSD
jQuery jQuery is a fast, small, and feature-rich JavaScript library. MIT
JS Beautifier Makes ugly Javascript pretty MIT

License

WordPress-iOS-Editor is available under the GPL license. See the LICENSE file for more info.