{"id":19328228,"url":"https://github.com/jndisrupter/jngroupavatarimageview","last_synced_at":"2025-04-22T21:30:44.343Z","repository":{"id":56916331,"uuid":"109768256","full_name":"JNDisrupter/JNGroupAvatarImageView","owner":"JNDisrupter","description":"Group avatar image","archived":false,"fork":false,"pushed_at":"2019-05-05T16:02:21.000Z","size":1543,"stargazers_count":13,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-11T07:07:52.715Z","etag":null,"topics":["avatar","avatarview","cocoapods","group","group-avatar","images-grid","initials-avatar","placeholder","swift","xcode"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JNDisrupter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-07T00:58:16.000Z","updated_at":"2023-09-08T17:32:15.000Z","dependencies_parsed_at":"2022-08-21T03:50:41.739Z","dependency_job_id":null,"html_url":"https://github.com/JNDisrupter/JNGroupAvatarImageView","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JNDisrupter%2FJNGroupAvatarImageView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JNDisrupter%2FJNGroupAvatarImageView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JNDisrupter%2FJNGroupAvatarImageView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JNDisrupter%2FJNGroupAvatarImageView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JNDisrupter","download_url":"https://codeload.github.com/JNDisrupter/JNGroupAvatarImageView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250328163,"owners_count":21412573,"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":["avatar","avatarview","cocoapods","group","group-avatar","images-grid","initials-avatar","placeholder","swift","xcode"],"created_at":"2024-11-10T02:21:02.540Z","updated_at":"2025-04-22T21:30:43.123Z","avatar_url":"https://github.com/JNDisrupter.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JNGroupAvatarImageView\n\n[![Version](https://img.shields.io/cocoapods/v/JNGroupAvatarImageView.svg?style=flat)](http://cocoapods.org/pods/JNGroupAvatarImageView)\n[![License](https://img.shields.io/cocoapods/l/JNGroupAvatarImageView.svg?style=flat)](http://cocoapods.org/pods/JNGroupAvatarImageView)\n[![Platform](https://img.shields.io/cocoapods/p/JNGroupAvatarImageView.svg?style=flat)](http://cocoapods.org/pods/JNGroupAvatarImageView)\n\n**JNGroupAvatarImageView** is used to show group or single avatar image with the option to show initials, it can show 4 images at most.\n\n## Screenshots\n\n\u003cimg src=\"https://github.com/JNDisrupter/JNGroupAvatarImageView/raw/development/Images/screenshot1.png\" width=\"280\"/\u003e\u003cimg src=\"https://github.com/JNDisrupter/JNGroupAvatarImageView/raw/development/Images/screenshot2.png\" width=\"280\"/\u003e\n\u003cimg src=\"https://github.com/JNDisrupter/JNGroupAvatarImageView/raw/development/Images/screenshot5.png\" width=\"280\"/\u003e\n\u003cimg src=\"https://github.com/JNDisrupter/JNGroupAvatarImageView/raw/development/Images/screenshot3.png\" width=\"280\"/\u003e\n\u003cimg src=\"https://github.com/JNDisrupter/JNGroupAvatarImageView/raw/development/Images/screenshot4.png\" width=\"280\"/\u003e\n\n## Requirements\n\n- iOS 9.0+ / macOS 10.10+\n- Xcode 9.0+\n- Swift 4+\n\n## Installation\n\n### CocoaPods\n\n[CocoaPods](http://cocoapods.org) is a dependency manager for Cocoa projects. You can install it with the following command:\n\n```bash\n$ gem install cocoapods\n```\n\nTo integrate JNGroupAvatarImageView into your Xcode project using CocoaPods, specify it in your `Podfile`:\n\n```ruby\n\nuse_frameworks!\n\ntarget '\u003cYour Target Name\u003e' do\n    pod 'JNGroupAvatarImageView'\nend\n```\n\nThen, run the following command:\n\n```bash\n$ pod install\n```\n## Usage\n\n#### To add JNGroupAvatarImageView in interface builder:\n\n1. Put some UIView and change the class to \"JNGroupAvatarImageView\"\n\n2. Add refrence for it in the view controller.\n\n3. Implement JNGroupAvatar In you class like the following:\n\n```swift\n class User : JNGroupAvatar {\n\n     /**\n       Get display name which will be used for the initials.\n     - Returns: The display name for the avatar\n     */\n    func getGroupAvatarDisplayName() -\u003e String {\n       return \"\"\n    }\n    \n    /**\n       Get Avatar image url which will be used as avatar url\n     - Returns: The image url\n     */\n    func getGroupAvatarImageUrl() -\u003e String {\n        return \"\"\n    }\n    \n     /**\n       Get Avatar image which will be used as avatar\n     - Returns: The image \n     */\n    func getGroupAvatarImage() -\u003e UIImage {\n        return UIImage()\n    }\n }\n ```\n\n4. Call setup method with the following parameters:\n \n```swift\n func setup(avatars : [JNGroupAvatar] , imagesLayoutDirection : ImagesLayoutDirection , avatarsMargin : CGFloat , separatorColor : UIColor, placeHolderImage : UIImage! , showInitails : Bool , initialsFont : UIFont , initialTextColor : UIColor)\n ```\n \n  * avatars : Array fo JNGroupAvatar which will be used to draw .\n  * imagesLayoutDirection : The image layout direction to use (right to left or left to right).\n  * avatarsMargin : The margin between avatars (separator with or height).\n  * separatorColor : The separator color to use.\n  * placeHolderImage : The placeholder to use if the image failed to load.\n  * showInitails : Show initials if the image failed to load or not, if false then set placeholder image.\n  * initialsFont : The font to use for the initials.\n  * initialTextColor : The text color to use for the initials.\n\n\u003e The libarary will automaticly adjust initials label insets if the view is circle.\n\n## Authors\n\nJayel Zaghmoutt \u0026 Mohammad Nabulsi\n\n## License\n\nJNGroupAvatarImageView is available under the MIT license. See the [LICENSE](https://github.com/JNDisrupter/JNGroupAvatarImageView/blob/master/LICENSE) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjndisrupter%2Fjngroupavatarimageview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjndisrupter%2Fjngroupavatarimageview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjndisrupter%2Fjngroupavatarimageview/lists"}