public
Description: A Cocoa framework which allows your users to submit bug reports, feature requests, and ask support questions from directly within your application.
Homepage:
Clone URL: git://github.com/tylerhall/OpenFeedback.git
name age message
file .gitignore Sat Aug 08 14:33:12 -0700 2009 Adding .gitignore [tylerhall]
directory English.lproj/ Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file Info.plist Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file OFUtilities.h Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file OFUtilities.m Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file OpenFeedback.h Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file OpenFeedback.m Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
directory OpenFeedback.xcodeproj/ Sat Aug 15 13:24:02 -0700 2009 Enabling support for garbage collection [tylerhall]
file OpenFeedback_Prefix.pch Sat Aug 08 14:33:40 -0700 2009 First commit from Google Code [tylerhall]
file README.markdown Sat Aug 15 13:36:58 -0700 2009 Fixing README formatting [tylerhall]
README.markdown

OpenFeedback

OpenFeedback is a Cocoa framework which allows your users to submit bug reports, feature requests, and ask support questions from directly within your application. It can store feedback in Shine or connect to your own custom server-side script. And, like Sparkle, OpenFeedback can be integrated into your application in just a few minutes - no code required.

INSTALL

Linking OpenFeedback to your project

  • Download and compile the lastest OpenFeedback source from GitHub.
  • Drag the compiled OpenFeedback.framework into the Linked Frameworks folder of your XCode project. Be sure to check the "copy items into the destination group's folder" box in the sheet that appears.
  • Create a new Copy Files build phase for your app's target (Project > New Build Phase > New Copy Files Build Phase).
  • Choose "Frameworks" as the destination for your new build phase.
  • Click the disclosure triangle next to your app's target, and drag OpenFeedback.framework from the Linked Frameworks folder to the Copy Files build phase you just created.

Create the OpenFeedback object

  • Open up your MainMenu.nib in Interface Builder.
  • Go to File > Read Class Files... and choose all the files inside OpenFeedback.framework/Headers.
  • Drag a generic Object (a blue cube) from the Library to your document.
  • Select this object in your document window, and under the Information tab of the inspector, set the class of the object to OpenFeedback. This will instantiate your OpenFeedback object.
  • Make a "Send Feedback..." menu item in the application menu; set its target to the OpenFeedback instance and its action to the appropriate presentFeedbackPanel...: action.

You're done!

(FYI: The above instrctions were pretty much copied verbatim from the Sparkle wiki, as the setup process is identical.)

UPDATES

Code is hosted at GitHub: http://github.com/tylerhall/projectname

LICENSE

The MIT License

Copyright (c) 2009 Tyler Hall

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.