🚨 Deprecation Notice: 🚨 As of December 2017 this project has been deprecated and will no longer be updated. The code is here for historical purposes only.

We encourage you to try Aztec, our new, open-source fully native HTML editor.

If you find Aztec is missing some functionality you were relying on from this editor, please file an issue in the Aztec repo.

---

WordPress-Editor-iOS

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, '10.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 10.0 or higher. It depends on the following Apple frameworks:

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

and the following CocoaPods:

• CocoaLumberjack
• WordPressCom-Analytics-iOS

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.