{"id":19319851,"url":"https://github.com/hyperoslo/mingle","last_synced_at":"2025-04-22T17:32:29.370Z","repository":{"id":14373755,"uuid":"17083762","full_name":"hyperoslo/mingle","owner":"hyperoslo","description":"Social media integration for Ruby on Rails","archived":false,"fork":false,"pushed_at":"2015-04-09T11:22:44.000Z","size":881,"stargazers_count":20,"open_issues_count":0,"forks_count":2,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-03-14T21:06:17.383Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://rubygems.org/gems/mingle","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"blox/blox","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperoslo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-22T11:47:16.000Z","updated_at":"2019-08-13T15:36:07.000Z","dependencies_parsed_at":"2022-08-27T00:43:25.469Z","dependency_job_id":null,"html_url":"https://github.com/hyperoslo/mingle","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperoslo%2Fmingle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperoslo%2Fmingle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperoslo%2Fmingle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperoslo%2Fmingle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperoslo","download_url":"https://codeload.github.com/hyperoslo/mingle/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223902264,"owners_count":17222343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T01:25:29.400Z","updated_at":"2024-11-10T01:25:30.005Z","avatar_url":"https://github.com/hyperoslo.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mingle\n\n[![Gem Version](https://img.shields.io/gem/v/mingle.svg?style=flat)](https://rubygems.org/gems/mingle)\n[![Build Status](https://img.shields.io/travis/hyperoslo/mingle.svg?style=flat)](https://travis-ci.org/hyperoslo/mingle)\n[![Dependency Status](https://img.shields.io/gemnasium/hyperoslo/mingle.svg?style=flat)](https://gemnasium.com/hyperoslo/mingle)\n[![Code Climate](https://img.shields.io/codeclimate/github/hyperoslo/mingle.svg?style=flat)](https://codeclimate.com/github/hyperoslo/mingle)\n[![Coverage Status](https://img.shields.io/coveralls/hyperoslo/mingle.svg?style=flat)](https://coveralls.io/r/hyperoslo/mingle)\n\nMingle makes it really easy to syndicate tweets from Twitter and photos from Instagram\nin your Ruby on Rails application.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'mingle'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install mingle\n\nInstall the migrations:\n\n    rake mingle:install:migrations\n\nRun the migrations:\n\n    rake db:migrate\n\n## Usage\n\n```ruby\n# Create some hashtags to syndicate content from\nMingle::Hashtag.create tag_name: \"#hyper\"\n\n# Fetch tweets from Twitter\nMingle::Twitter.fetch\n\n# Fetch photos from Instagram\nMingle::Instagram.fetch\n```\n\nMingle also ships with rake tasks:\n\n```bash\n$ rake mingle:twitter:fetch\n$ rake mingle:instagram:fetch\n```\n\n## Jobs\n\nMingle ships with Sidekiq jobs for your perusal.\n\n## Configuration\n\nMingle is configured through `Mingle.configure`, like this:\n\n```ruby\nMingle.configure do |config|\n  config.twitter_api_key = ENV['TWITTER_API_KEY']\n  # ...\nend\n```\n\nYou can also configure it temporarily:\n\n```ruby\nMingle.temporarily twitter_api_key: 'ABC123' do\n  # ...\nend\n```\n\nThe following configurations can be made through `Mingle.configure`:\n\n* `twitter_api_key` - A Twitter application's API key.\n* `twitter_api_secret` - A Twitter application's API secret.\n* `twitter_access_token` - A Twitter application's access token.\n* `twitter_access_token_secret` - A Twitter application's access token secret.\n* `instagram_client_id` - An Instagram application's client id.\n* `twitter_reject_words` - An array of words which will prevent a tweet from being imported.\n* `twitter_reject_users` - An array of Twitter user names whose tweets will not be imported.\n* `instagram_reject_words` - An array of words which will prevent an Instagram photo from being imported.\n* `instagram_reject_users` - An array of Instagram user names whose Instagram photos will not be imported.\n* `since` - A date before which posts, tweets and photos will be ignored.\n\n**Note:** We recommend you store your application configuration in your\nenvironment, like in the example above. In fact, we recommend it so much that\nMingle will automatically look for environment variables with specific names,\nunless you configure them through `Mingle.configure`.\n\nMingle checks for following environment variables by default:\n\n* `TWITTER_API_KEY` - the equivalent of `twitter_api_key`\n* `TWITTER_API_SECRET` - the equivalent of `twitter_api_secret`\n* `TWITTER_ACCESS_TOKEN` - the equivalent of `twitter_access_token`\n* `TWITTER_ACCESS_TOKEN_SECRET` - the equivalent of `twitter_access_token_secret`\n* `INSTAGRAM_CLIENT_ID` - the equivalent of `instagram_client_id`\n\n## Contributing\n\n1. Fork it\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n\n## Credits\n\nHyper made this. We're a digital communications agency with a passion for good code,\nand if you're using this library we probably want to hire you.\n\n\n## License\n\nMingle is available under the MIT license. See the LICENSE file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperoslo%2Fmingle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperoslo%2Fmingle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperoslo%2Fmingle/lists"}