Skip to content
This repository has been archived by the owner on Nov 14, 2022. It is now read-only.

Latest commit

 

History

History
139 lines (104 loc) · 5.22 KB

README.md

File metadata and controls

139 lines (104 loc) · 5.22 KB

Apereo Weather Portlet

Maven Central build status

This is a Sponsored Portlet in the uPortal project.

Link to old documentation

Table of Contents

Description

The Apereo Weather Portlet is a fully-functional JSR-286 Java portlet that provides international weather using either World Weather Online or Yahoo Weather. If permitted, end users have the ability add and delete multiple locations and standards of measurement with ease!

The Weather Portlet has been bundled with uPortal since 3.2.0.

Configuration

Weather Locations

The default weather service is Yahoo! Weather. Weather locations are most commonly configured by the portal developer/administrator using portlet preferences. Currently this method does not require an API key.

Example Weather Locations Configuration:

<portlet-preference>
    <name>locationCodes</name>
    <value>2459115</value>
    <value>1118370</value>
</portlet-preference>
<portlet-preference>
    <name>locations</name>
    <value>New York, NY</value>
    <value>Tokyo, Japan(Tokyo)</value>
</portlet-preference>
<portlet-preference>
    <name>units</name>
    <value>F</value>
    <value>C</value>
</portlet-preference>
<portlet-preference>
    <name>showEditLink</name>
    <value>false</value>
</portlet-preference>

You can discover locationCodes for your locations by inspecting the URL of the associated page in Yahoo! Weather. For example, the following URL belongs to the Yahoo! Weather page for Phoenix, AZ:

The location code for Phoenix is 2471390.

Yahoo! Weather API Key

The Apereo Weather Portlet includes an optional EDIT mode that allows end users to manage their own weather locations. To use it, you must provide a valid API key from developer.yahoo.com.

To obtain an API key, you must Create an App in the Yahoo! Developer Network portal. Once you create your app, copy the Client Secret (Consumer Secret) that Yahoo! generates.

Paste the Client Secret in the space provided within src/main/webapp/WEB-INF/context/applicationContext.xml:

<!--
    Yahoo! Weather DAO Implementation
-->

<bean id="weatherDaoImpl" class="org.jasig.portlet.weather.dao.yahoo.YahooWeatherDaoImpl">
    <property name="key" value=""/> <!--  ENTER YOUR KEY HERE -->
    <property name="weatherParsingService" ref="weatherParsingService"/>
    <property name="locationParsingService" ref="locationParsingService"/>
    <property name="messageSource" ref="messageSource"/>
</bean>

As with all portlets, you must package and deploy a new build of the Weather Portlet for this change to take effect.

Where to Get Help

The [email protected] mailing list is the best place to go with questions related to Apereo portlets and uPortal.

Issues should be reported at https://issues.jasig.org/browse/WPT. Check if your issue has already been reported. If so, comment that you are also experiencing the issue and add any detail that could help resolve it. Feel free to create an issue if it has not been reported. Creating an account is free and can be initiated at the Login widget in the default dashboard.

Contribution Guidelines

Apereo requires contributors sign a contributor license agreement (CLA). We realize this is a hurdle. To learn why we require CLAs, see "Q5. Why does Apereo require Contributor License Agreements (CLAs)?" at https://www.apereo.org/licensing.

The CLA form(s) can be found https://www.apereo.org/licensing/agreements along with the various ways to submit the form.

Contributions will be accepted once the contributor's name appears at http://licensing.apereo.org/completed-clas.

See https://www.apereo.org/licensing for details.

License

Copyright 2016 Apereo Foundation, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

See https://www.apereo.org/licensing for additional details.