{"id":13339890,"url":"https://github.com/uPortal-Attic/email-preview","last_synced_at":"2025-03-11T15:31:40.616Z","repository":{"id":2727278,"uuid":"3722305","full_name":"uPortal-Attic/email-preview","owner":"uPortal-Attic","description":null,"archived":true,"fork":false,"pushed_at":"2022-12-13T00:22:22.000Z","size":1735,"stargazers_count":7,"open_issues_count":16,"forks_count":22,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-10-24T02:34:51.672Z","etag":null,"topics":["email-portlet","hacktoberfest","java","portal","portlet","uportal","uportal-start-bundled"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/uPortal-Attic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-03-14T21:02:46.000Z","updated_at":"2024-01-12T18:05:18.000Z","dependencies_parsed_at":"2023-01-13T12:03:09.376Z","dependency_job_id":null,"html_url":"https://github.com/uPortal-Attic/email-preview","commit_stats":null,"previous_names":["jasig/email-preview"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2Femail-preview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2Femail-preview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2Femail-preview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2Femail-preview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uPortal-Attic","download_url":"https://codeload.github.com/uPortal-Attic/email-preview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243059645,"owners_count":20229614,"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":["email-portlet","hacktoberfest","java","portal","portlet","uportal","uportal-start-bundled"],"created_at":"2024-07-29T19:21:21.508Z","updated_at":"2025-03-11T15:31:40.190Z","avatar_url":"https://github.com/uPortal-Attic.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Email Preview Portlet\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.jasig.portlet/email-preview/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.jasig.portlet/email-preview)\n[![build status](https://github.com/uPortal-Project/email-preview/workflows/CI/badge.svg?branch=master)](https://github.com/uPortal-Project/email-preview/actions)\n\nThe Email Preview Portlet is a JSR-268 read-only email portlet. This portlet allows a user to connect to an IMAP, POP3, or Exchange Web Services email store and view and manage contents of INBOX and other mail folders.\n\nThis is a [Sponsored Portlet](https://wiki.jasig.org/display/PLT/Jasig+Sponsored+Portlets) in the Apereo uPortal project.\n\nIssue Tracker: \u003chttps://issues.jasig.org/browse/EMAILPLT\u003e\n\nLicense: [Apache Software License, version 2.0](LICENSE)\n\n## Features\n\n*   Display total message count \u0026 unread message count\n*   Display the contents of your Inbox or any folder on the mail server\n*   Display messages in a table, with the following information for each message\n    +   Subject\n    +   Sender\n    +   Date Sent\n    +   Whether the message has been previously viewed\n    +   Whether the message contains attachments\n*   Page through your messages \u0026 choose page size\n*   Check for new messages (\"Refresh\")\n*   Click on a message to view it's content\n*   Display customizable Welcome message\n*   Display customizable Help text\n*   Provide authentication via cached credential replay or user-specified preferences\n*   Uses Antisamy to protect against cross-site scripting (XSS)\n\n## Administrator Settings\n\nThese may be configured by the administrator or omitted. The following connection settings apply to IMAP/POP integration. **Exchange Web Services support is also available.**\n\n*   Protocol - IMAP(S) or POP(S)\n*   Mail Server (host)\n*   Port\n*   Inbox Folder Name\n*   Timeout\n*   Connection Timeout\n*   Inbox URL (for click-through into the webmail client)\n*   Link Service\n*   Authentication Service (cachePassword and/or portletPreferences)\n*   Which settings, if any, users may configure (see below)\n\n## User Settings\n\nThese may be set by users if permitted by the administrator. If any field is defined by both the admin and the user, the user's value is used.\n\n*   Protocol (not including Exchange Web Services)\n*   Mail Server (host)\n*   Port\n*   Mailbox folder name\n*   Mark Messages Read\n*   Username (portletPreferences authentication only)\n*   Password (portletPreferences authentication only)\n*   Show rollup (smaller) or preview (larger) on login\n*   Focus on Preview\n\n## Configuration\n\nSee also the [legacy documentation in the external wiki][].\n\n### Java Properties\n\nSome configuration settings for the Email Preview portlet are managed in Java properties files that\nare loaded by a Spring `PropertySourcesPlaceholderConfigurer`.  (Other settings are data, managed in\nthe \"portlet publication record\" a.k.a. `portlet-definition.xml` file\n\nThe properties files that are sourced by Spring are:\n\n  - `classpath:configuration.properties`\n  - `file:${portal.home}/global.properties`\n  - `file:${portal.home}/email-preview.properties`\n\nFor a definitive, comprehensive list of these settings you must look inside `configuration.properties`.\n(This `README` may be incomplete and/or out of date.)\n\n#### The `portal.home` Directory\n\nuPortal version 5 uses a directory called `portal.home` for properties files that live outside of\n-- and have the ability to _override_ properties files within-- the webapp in Tomcat.  Please\nreview the [README file for uPortal-Start][] for more information on this system.\n\nThe Notification portlet sources the shared `global.properties` file, as well as it's own (private)\nfile called `email-preview.properties` in the `portal.home` directory.\n\n#### Using Encrypted Property Values\n\nWithin the properties files that are sourced by Spring, you may optionally provide sensitive\nconfiguration items -- such as database passwords -- in encrypted format.  Use the\n[Jasypt CLI Tools][] to encrypt the sensitive value, then include it in a `.properties` file\nlike this:\n\n```\nhibernate.connection.password=ENC(9ffpQXJi/EPih9o+Xshm5g==)\n```\n\nSpecify the encryption key using the `UP_JASYPT_KEY` environment variable.\n\n## Contributing\n\nThis project follows the [uPortal Contributing Guidelines](https://github.com/Jasig/uPortal/blob/master/CONTRIBUTING.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuPortal-Attic%2Femail-preview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FuPortal-Attic%2Femail-preview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuPortal-Attic%2Femail-preview/lists"}