PARTagPicker/PARTagPicker.podspec at master · paulrolfe/PARTagPicker · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
#
#  Be sure to run `pod spec lint PARTagPicker.podspec' to ensure this is a
#  valid spec and to remove all comments including this before submitting the spec.
#
#  To learn more about Podspec attributes see http://docs.cocoapods.org/specification.html
#  To see working Podspecs in the CocoaPods repo see https://github.com/CocoaPods/Specs/
#

Pod::Spec.new do |s|

  s.name         = "PARTagPicker"
  s.version      = "1.4.0"
  s.summary      = "This pod provides a view controller for choosing and creating tags in the style of wordpress or tumblr."
  s.homepage     = "https://github.com/paulrolfe/PARTagPicker"
  s.screenshots  = "https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record1.gif", "https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record2.gif", "https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record3.gif", "https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record4.gif"
  s.license      = "MIT"
  s.author             = { "Paul Rolfe" => "paul.a.rolfe@gmail.com" }
  s.social_media_url   = "http://twitter.com/thepaulrolfe"
  s.platform     = :ios, "6.0"
  s.source       = { :git => "https://github.com/paulrolfe/PARTagPicker.git", :tag => "#{s.version}" }
  s.source_files  = "PARTagPicker/Classes/*.{h,m}"
  s.resource_bundle = {"PARTagPicker" => "PARTagPicker/Resources/*.xib"}
  s.framework  = "UIKit"
  s.requires_arc = true
  s.description  = <<-DESC
  # PARTagPicker

  This pod provides a view controller for choosing and creating tags in the style of wordpress or tumblr. This tag picker was originally used in the [Intrepid Pursuits](http://intrepid.io) app, Slate.

  ## DEMO

  As used in Slate:

  ![DEMO IN SLATE](https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record1.gif)
  ![DEMO IN SLATE](https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record4.gif)

  From example project:

  ![DEMO IN EXAMPLE](https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record2.gif)
  ![DEMO IN EXAMPLE](https://s3.amazonaws.com/Paul.Image.Bucket/PRTagPicker/tag_record3.gif)

  ## Installation

  PARTagPicker is available through [CocoaPods](http://cocoapods.org). To install
  it, simply add the following line to your Podfile:

  ```ruby
  pod 'PARTagPicker'
  ```

  ## Usage

  To run the example project, clone the repo, and run `pod install` from the PRTagPicker directory first.

  Include `#import <PARTagPicker/PARTagPickerViewController.h>`.

  The basic setup is to create an instance of `PARTagPickerViewController`, add it's view, and then add the controller as a child view controller.

  The tags are passed in as `NSString` objects in an array. Anytime you change the `allTags` array, any existing `chosenTags` are updated to use references to the new strings if they contain a match in the updated array. Otherwise they continue to point to the old strings.

  ## Options
  * You can customize colors using a PARTagColorReference object.
  * You can allow new tags with `allowsNewTags` boolean property on the controller.
  * You can set the `chosenTags` directly.
  * Delegate methods for when the chosenTags change and the tag picker changes size.
  * `- (void)tagPicker:(PARTagPickerViewController *)tagPicker visibilityChangedToState:(PARTagPickerVisibilityState)state `
  * `- (void)chosenTagsWereUpdatedInTagPicker:(PARTagPickerViewController *)tagPicker`

  ## Notes

  This is still a work in progress. If you have suggestions or run into issues, please create an issue on git or tweet me [@ThePaulRolfe](http://twitter.com/thepaulrolfe).

  ## Updates
  * v1.4.0 - Swift example, expose cleaner PARTagColorReference init.
  * v1.0.3 - Making safe from some unexpected nil values.
  * v1.0.2 - Including `.xib`s in the pod now. Oops!
  * v1.0.0 - Added documentation and fixed bug with deselecting chosenTags. Added ability to use custom fonts in the tag cells.
  * v0.0.5 - Added expected functionality of chosenTags being removed when pressed.

  ## Author

  Paul Rolfe, paul.a.rolfe@gmail.com, [@ThePaulRolfe](http://twitter.com/thepaulrolfe)

  ## License

  PARTagPicker is available under the MIT license. See the LICENSE file for more info.

                   DESC
end