CBPWordPress, 一个用来访问WordPress博客的图书馆

分享于 

6分钟阅读

GitHub

  繁體 雙語
A library to access a WordPress blog,
  • 源代码名称:CBPWordPress
  • 源代码网址:http://www.github.com/kmonaghan/CBPWordPress
  • CBPWordPress源代码文档
  • CBPWordPress源代码下载
  • Git URL:
    git://www.github.com/kmonaghan/CBPWordPress.git
    Git Clone代码到本地:
    git clone http://www.github.com/kmonaghan/CBPWordPress
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/kmonaghan/CBPWordPress
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    CBPWordPress

    CBPWordPress 是一个用来在你的应用程序中显示WordPress博客内容的库。

    要求

    你将需要安装并激活你的WordPress安装中的 WP-JSON-API插件插件的Broadsheet.ie。

    安装

    CocoaPods安装

    是用于 objective-c的依赖管理器,它在你的项目中自动化和简化使用 3个rd库的过程。 有关详细信息,请参阅入门入门节。

    Podfile
    
    pod 'CBPWordPress'
    
    
    
    

    用法

    把这个库指向你自己的WordPress安装是很简单的。 对库的第一个调用应该是设置API的root URL。

    
    [CBPWordPressAPIClient rootURI:@"http://YOUR-API-URL"];
    
    
    
    

    一旦设置,对API的调用将使用该 URL。

    获取一个日志列表

    要获得帖子列表,你可以使用 NSURLSessionDataTask 类别中的fetchPostsWithParams:withBlock: 方法。

    在示例 below 中,最近的文章的第一页被检索并且分配给 array的文章。

    
    __weak typeof(self) weakSelf = self;
    
    
    
    [NSURLSessionDataTask fetchPostsWithParams:@{@"page": @(1)}
    
    
     withBlock:^(CBPWordPressPostsContainer *data, NSError *error) {
    
    
     if (error) {
    
    
    //Handle Error
    
    
     return;
    
    
     }
    
    
    
     __strong typeof(weakSelf) strongSelf = weakSelf;
    
    
    
     strongSelf.posts = data.posts;
    
    
    }];
    
    
    
    

    允许的参数包括:

    • 页面:要获取的页面。 从 1开始。
    • 计数:要检索的日志数。 默认为 10.

    获取帖子

    如果知道帖子 id,你可以从 NSURLSessionDataTask 类别中使用 fetchPostWithId:withBlock: 方法获取帖子。 示例 below 获取 post 1234并将它的赋给本地post变量。

    
    __weak typeof(self) weakSelf = self;
    
    
    
    [NSURLSessionDataTask fetchPostWithId:1234
    
    
     withBlock:^(CBPWordPressPost *post, NSError *error){
    
    
     if (error) {
    
    
    //Handle Error
    
    
     return;
    
    
     }
    
    
    
     __strong typeof(weakSelf) strongSelf = weakSelf;
    
    
    
     strongSelf.post = post;
    
    
    }];
    
    
    
    
    

    如果你有帖子的URL,则可以使用 fetchPostWithURL:withBlock: 方法。 你将post的完整URL作为参数传递。

    对帖子的评论

    要对帖子进行评论,请使用 NSURLSessionDataTask 类别中的postComment:withBlock: 方法。 方法将CBPWordPressComment对象作为第一个参数。 below 是一个初始化的示例注释。

    
    CBPWordPressComment *newComment = [CBPWordPressComment new];
    
    
    newComment.postId = 1234;
    
    
    newComment.email = @"example@example.com";
    
    
    newComment.name = @"Jonny Appleseed";
    
    
    newComment.content = @"This is a comment!";
    
    
    //Optional
    
    
    newComment.url = @"http://somewebsite.com";
    
    
    //If the comment is replying to another comment
    
    
    newComment.parent = 1234;
    
    
    
    

    请注意,URL和父属性是可选的,但是需要其他。 如果用户回复注释并应该是注释的of,则只应设置父属性。

    初始化注释后,将它的传递给 postComment:withBlock: 方法。 在以下示例中,提交新注释并成功设置为返回的注释对象。

    
    __weak typeof(self) weakSelf = self;
    
    
    
    [NSURLSessionDataTask postComment:newComment
    
    
     withBlock:^(CBPWordPressComment *comment, NSError *error){
    
    
     __strong typeof(weakSelf) strongSelf = weakSelf;
    
    
    
     if (error) {
    
    
    //Handle error
    
    
     return;
    
    
     }
    
    
    
     strongSelf.comment = newComment;
    
    
    }];
    
    
    
    

    如果WordPress发现重复的评论,结果返回为HTML而不是 JSON。

    图书馆是一个进行中的工作。 要添加的一些计划功能是: - 添加选项从 [WP-API] ( https://github.com/WP-API/WP-API ) 插件获取数据- 为每个WP-JSON-API端点(。get_category_posts,get_tag_posts 等等 ) 实现 helper 方法- 向示例应用程序添加 [Today Extension] ( http://www.karlmonaghan.com/2014/06/17/creating-an-ios-framework-and-today-extension/ )

    欢迎通过拉请求和建议进行贡献。

    联系人

    卡尔。Monaghan

    许可证

    CBPWordPress在MIT许可证下可用。 有关详细信息,请参阅许可证文件。


    acc  WORD  Wordpress  blog  
    相关文章