{"id":23688432,"url":"https://github.com/pscourtney/blazorgravatar","last_synced_at":"2025-09-02T16:32:02.387Z","repository":{"id":264166886,"uuid":"892564895","full_name":"PSCourtney/BlazorGravatar","owner":"PSCourtney","description":"A Gravatar blazor component for use in Blazor SSR, Server or WASM","archived":false,"fork":false,"pushed_at":"2024-11-27T12:51:01.000Z","size":771,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-27T15:35:59.224Z","etag":null,"topics":["blazor","blazor-example","blazor-server","blazor-wasm","blazor-webassembly","dotnet","dotnet-core","gravatar","gravatar-api","gravatar-url"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/BlazorGravatar","language":"CSS","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/PSCourtney.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-22T10:59:55.000Z","updated_at":"2024-11-29T10:22:08.000Z","dependencies_parsed_at":"2024-11-22T12:18:43.925Z","dependency_job_id":"ca20c4e6-f2ef-45c3-bdca-8e2291011a6d","html_url":"https://github.com/PSCourtney/BlazorGravatar","commit_stats":null,"previous_names":["pscourtney/blazorgravatar"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSCourtney%2FBlazorGravatar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSCourtney%2FBlazorGravatar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSCourtney%2FBlazorGravatar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PSCourtney%2FBlazorGravatar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PSCourtney","download_url":"https://codeload.github.com/PSCourtney/BlazorGravatar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231798419,"owners_count":18428161,"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":["blazor","blazor-example","blazor-server","blazor-wasm","blazor-webassembly","dotnet","dotnet-core","gravatar","gravatar-api","gravatar-url"],"created_at":"2024-12-30T00:17:58.205Z","updated_at":"2024-12-30T00:18:00.353Z","avatar_url":"https://github.com/PSCourtney.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlazorGravatar https://github.com/PSCourtney/BlazorGravatar\n\n![NuGet Downloads](https://img.shields.io/nuget/dt/BlazorGravatar?label=NuGet%20Downloads\u0026color=blue) \n![License](https://img.shields.io/github/license/PSCourtney/BlazorGravatar)\n![Last Commit](https://img.shields.io/github/last-commit/PSCourtney/BlazorGravatar)\n\nThe **BlazorGravatar** library is a Blazor component that generates Gravatar profile images based on email addresses. It supports customizable image sizes, classes, alt text, and fallback options for default images and ratings.\n\n## 📒 Features\n\n- Automatically generates a Gravatar image URL based on the provided email address.\n- Supports optional parameters for customizing image size, default fallback image, and rating level.\n- Easy-to-use Razor syntax for integration into your Blazor project.\n\n## 🛠 Installation\n\n1. Install the NuGet package (replace `\u003cversion\u003e` with the latest version):\n\n   ```bash\n   dotnet add package BlazorGravatar --version \u003cversion\u003e\n   ```\n\n2. Add the namespace to your `_Imports.razor` file for convenience:\n\n   ```razor\n   @using BlazorGravatar\n   ```\n\n## 🚀 Usage\n\n### 🔹 Basic Example\n\nRender a Gravatar image for an email address:\n\n```razor\n\u003cBlazorGravatar Email=\"user@example.com\" Alt=\"User's Gravatar\" /\u003e\n```\n\n### 🔸 Custom Size, Class, and Default Image\n\n```razor\n\u003cBlazorGravatar\n    Email=\"user@example.com\"\n    Alt=\"User's Profile Image\"\n    Size=\"100\"\n    Class=\"profile-picture\"\n    DefaultImage=\"retro\"\n/\u003e\n```\n\n## ⚙️ Parameters\n\n| Parameter      | Type     | Description                                                                                 | Default |\n| -------------- | -------- | ------------------------------------------------------------------------------------------- | ------- |\n| `Email`        | `string` | **Required**. The email address used to fetch the Gravatar image.                           | N/A     |\n| `Class`        | `string` | CSS class to style the `\u003cimg\u003e` element.                                                     | `null`  |\n| `Alt`          | `string` | Alternative text for the `\u003cimg\u003e` element.                                                   | `null`  |\n| `Size`         | `int?`   | Image size in pixels. Must be between `1` and `2048`.                                       | `null`  |\n| `DefaultImage` | `string` | Default image if no Gravatar is found. Options: `404`, `mp`, `identicon`, `monsterid`, etc. | `\"mp\"`  |\n| `Rating`       | `string` | Maximum rating of images allowed: `g`, `pg`, `r`, or `x`.                                   | `\"g\"`   |\n\n## 🖼️ Supported Default Images\n\n- `404`: Do not load any image; return an HTTP 404 instead.\n- `mp`: Mystery Person silhouette (default).\n- `identicon`: Geometric pattern based on email hash.\n- `monsterid`: Monster face generated based on email hash.\n- `retro`: 8-bit arcade-style image.\n- And more... see [Gravatar's official documentation](https://en.gravatar.com/site/implement/images/).\n\n## 🎨 Example with Styling\n\nAdd custom styles for the Gravatar image:\n\n```razor\n\u003cBlazorGravatar\n    Email=\"user@example.com\"\n    Alt=\"Avatar\"\n    Class=\"rounded-circle shadow-sm\"\n    Size=\"150\"\n/\u003e\n```\n\n```css\n/* Custom CSS */\n.rounded-circle {\n    border-radius: 50%;\n}\n\n.shadow-sm {\n    box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);\n}\n```\n\n## ⚙️ How It Works\n\nThe **BlazorGravatar** component normalizes the email address (lowercase and trimmed), computes an SHA256 hash, and generates the Gravatar URL. Optional parameters like size, default image, and rating are added as query parameters.\n\n## 🤝 Contributing\n\n1. Fork the repository.\n2. Create a new branch for your feature or bug fix.\n3. Commit and push your changes.\n4. Submit a pull request with a detailed explanation of your changes.\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## 🙏 Acknowledgments\n\nThe Gravatar API is provided by [Gravatar.com](https://gravatar.com).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpscourtney%2Fblazorgravatar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpscourtney%2Fblazorgravatar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpscourtney%2Fblazorgravatar/lists"}