{"id":13339889,"url":"https://github.com/uPortal-Attic/WeatherPortlet","last_synced_at":"2025-03-11T15:31:44.660Z","repository":{"id":2727277,"uuid":"3722304","full_name":"uPortal-Attic/WeatherPortlet","owner":"uPortal-Attic","description":"Java Portlet for viewing weather.","archived":true,"fork":false,"pushed_at":"2022-10-24T03:09:39.000Z","size":13806,"stargazers_count":5,"open_issues_count":17,"forks_count":19,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-10-24T02:34:54.512Z","etag":null,"topics":["hacktoberfest","java","portal","portlet","uportal","uportal-start-bundled","weather","weather-locations","weather-portlet"],"latest_commit_sha":null,"homepage":"https://wiki.jasig.org/display/PLT/Weather+Portlet","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":null,"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:33.000Z","updated_at":"2022-11-14T18:59:40.000Z","dependencies_parsed_at":"2023-01-11T16:12:08.251Z","dependency_job_id":null,"html_url":"https://github.com/uPortal-Attic/WeatherPortlet","commit_stats":null,"previous_names":["jasig/weatherportlet"],"tags_count":34,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2FWeatherPortlet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2FWeatherPortlet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2FWeatherPortlet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/uPortal-Attic%2FWeatherPortlet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/uPortal-Attic","download_url":"https://codeload.github.com/uPortal-Attic/WeatherPortlet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243059680,"owners_count":20229617,"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":["hacktoberfest","java","portal","portlet","uportal","uportal-start-bundled","weather","weather-locations","weather-portlet"],"created_at":"2024-07-29T19:21:21.501Z","updated_at":"2025-03-11T15:31:43.480Z","avatar_url":"https://github.com/uPortal-Attic.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apereo Weather Portlet\n\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.jasig.portlet/WeatherPortlet/badge.svg)](https://maven-badges.herokuapp.com/maven-central/org.jasig.portlet/WeatherPortlet)\n[![build status](https://github.com/uPortal-Project/WeatherPortlet/workflows/CI/badge.svg?branch=master)](https://github.com/uPortal-Project/WeatherPortlet/actions)\n\nThis is a [Sponsored Portlet][] in the uPortal project.\n\n[Link to old documentation](https://wiki.jasig.org/display/PLT/Weather+Portlet)\n\n## Table of Contents\n  - [Description](#desc)\n  - [Configuration](#config)\n    - [Weather Locations](#locations)\n    - [Yahoo! Weather API Key](#yahoo!)\n  - [Where to Get Help](#help)\n  - [Contribution Guidelines](#contrib)\n  - [License](#license)\n\n## \u003ca name=\"desc\"\u003e\u003c/a\u003e Description\n\nThe Apereo Weather Portlet is a fully-functional JSR-286 Java portlet that provides\ninternational weather using either World Weather Online or Yahoo Weather. If permitted,\nend users have the ability add and delete multiple locations and standards of measurement\nwith ease!\n\nThe Weather Portlet has been bundled with uPortal since 3.2.0.\n\n## \u003ca name=\"config\"\u003e\u003c/a\u003e Configuration\n\n### \u003ca name=\"locations\"\u003e\u003c/a\u003e Weather Locations\n\nThe default weather service is [Yahoo! Weather](https://developer.yahoo.com/weather/).\nWeather locations are most commonly configured by the portal developer/administrator\nusing portlet preferences. **Currently this method does not require an API key.**\n\n#### Example Weather Locations Configuration:\n\n``` xml\n\u003cportlet-preference\u003e\n    \u003cname\u003elocationCodes\u003c/name\u003e\n    \u003cvalue\u003e2459115\u003c/value\u003e\n    \u003cvalue\u003e1118370\u003c/value\u003e\n\u003c/portlet-preference\u003e\n\u003cportlet-preference\u003e\n    \u003cname\u003elocations\u003c/name\u003e\n    \u003cvalue\u003eNew York, NY\u003c/value\u003e\n    \u003cvalue\u003eTokyo, Japan(Tokyo)\u003c/value\u003e\n\u003c/portlet-preference\u003e\n\u003cportlet-preference\u003e\n    \u003cname\u003eunits\u003c/name\u003e\n    \u003cvalue\u003eF\u003c/value\u003e\n    \u003cvalue\u003eC\u003c/value\u003e\n\u003c/portlet-preference\u003e\n\u003cportlet-preference\u003e\n    \u003cname\u003eshowEditLink\u003c/name\u003e\n    \u003cvalue\u003efalse\u003c/value\u003e\n\u003c/portlet-preference\u003e\n```\n\nYou can discover `locationCodes` for your locations by inspecting the URL of the\nassociated page in Yahoo! Weather.  For example, the following URL belongs to the\nYahoo! Weather page for Phoenix, AZ:\n\n  - \u003chttps://www.yahoo.com/news/weather/united-states/arizona/phoenix-2471390/\u003e\n\nThe location code for Phoenix is 2471390.\n\n### \u003ca name=\"yahoo!\"\u003e\u003c/a\u003e Yahoo! Weather API Key\n\nThe Apereo Weather Portlet includes an optional EDIT mode that allows end users to\nmanage their own weather locations.  To use it, you must provide a valid API key\nfrom developer.yahoo.com.\n\nTo obtain an API key, you must [Create an App](https://developer.yahoo.com/apps/create)\nin the Yahoo! Developer Network portal.  Once you create your app, copy the\n`Client Secret (Consumer Secret)` that Yahoo! generates.\n\nPaste the `Client Secret` in the space provided within\n`src/main/webapp/WEB-INF/context/applicationContext.xml`:\n\n``` xml\n\u003c!--\n    Yahoo! Weather DAO Implementation\n--\u003e\n\n\u003cbean id=\"weatherDaoImpl\" class=\"org.jasig.portlet.weather.dao.yahoo.YahooWeatherDaoImpl\"\u003e\n    \u003cproperty name=\"key\" value=\"\"/\u003e \u003c!--  ENTER YOUR KEY HERE --\u003e\n    \u003cproperty name=\"weatherParsingService\" ref=\"weatherParsingService\"/\u003e\n    \u003cproperty name=\"locationParsingService\" ref=\"locationParsingService\"/\u003e\n    \u003cproperty name=\"messageSource\" ref=\"messageSource\"/\u003e\n\u003c/bean\u003e\n```\n\nAs with all portlets, you must package and deploy a new build of the Weather Portlet\nfor this change to take effect.\n\n## \u003ca name=\"help\"\u003e\u003c/a\u003e Where to Get Help\nThe \u003cuportal-user@apereo.org\u003e mailing list is the best place to go with\nquestions related to Apereo portlets and uPortal.\n\nIssues should be reported at \u003chttps://issues.jasig.org/browse/WPT\u003e.\nCheck if your issue has already been reported. If so, comment that you are also\nexperiencing the issue and add any detail that could help resolve it. Feel free to\ncreate an issue if it has not been reported. Creating an account is free and can be\ninitiated at the Login widget in the default dashboard.\n\n## \u003ca name=\"contrib\"\u003e\u003c/a\u003e Contribution Guidelines\nApereo requires contributors sign a contributor license agreement (CLA).\nWe realize this is a hurdle. To learn why we require CLAs, see\n\"Q5. Why does Apereo require Contributor License Agreements (CLAs)?\"\nat \u003chttps://www.apereo.org/licensing\u003e.\n\nThe CLA form(s) can be found \u003chttps://www.apereo.org/licensing/agreements\u003e along\nwith the various ways to submit the form.\n\nContributions will be accepted once the contributor's name appears at\n\u003chttp://licensing.apereo.org/completed-clas\u003e.\n\nSee \u003chttps://www.apereo.org/licensing\u003e for details.\n\n## \u003ca name=\"license\"\u003e\u003c/a\u003e License\n\nCopyright 2016 Apereo Foundation, Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this project except in compliance with the License.\nYou may obtain a copy of the License at\n\n\u003chttp://www.apache.org/licenses/LICENSE-2.0\u003e\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\nSee \u003chttps://www.apereo.org/licensing\u003e for additional details.\n\n[Sponsored Portlet]: https://wiki.jasig.org/display/PLT/Jasig+Sponsored+Portlets\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuPortal-Attic%2FWeatherPortlet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FuPortal-Attic%2FWeatherPortlet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FuPortal-Attic%2FWeatherPortlet/lists"}