search

wordpress-mobile / WordPress-Editor-iOS

⛔️ [DEPRECATED] A reusable iOS rich text editor component.
GNU General Public License v2.0
1.06k stars 209 forks source link

readme

🚨 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.

Aztec's Logo'

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.

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, '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:

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.