# Setting up My Yahoo! Enterprise Edition

To set up and use My Yahoo! Enterprise Edition in your portals, perform the following steps:

- Add My Yahoo! Enterprise Edition to your portal application
- Set up a trial account
- Activate support for anonymous users
- Set up a model account

To add My Yahoo! Enterprise Edition to your portal application

1. Create a portal application. Make sure you create a Portal Application and add a Portal Web Project to it.
2. Make sure your server is running. With your portal application open in WebLogic Workshop, choose Tools-->WebLogic Server-->Start WebLogic Server.
3. Import or copy the following directories and files into your portal application and portal Web project. You may need to create the appropriate directories in your application:

   Import or copy this | to this directory (create if necessary)
   <WEBLOGIC_HOME>\samples\portal\portalApp\ sampleportal\portlets\yahoo\ | <PORTAL_APP>\<project>\portlets\
   <WEBLOGIC_HOME>\samples\portal\portalApp\ sampleportal\yahoo\ | <PORTAL_APP>\<project>\
   <WEBLOGIC_HOME>\samples\portal\portalApp\ sampleportal\ yahoo_locale.properties | <PORTAL_APP>\<project>\
   <WEBLOGIC_HOME>\samples\portal\portalApp\ META-INF\data\userprofiles\ YahooEnterprise.usr | <PORTAL_APP>\data\userprofiles\
   <WEBLOGIC_HOME>\samples\portal\portalApp\ sampleportal\WEB-INF\lib\ yahoo_servlet.jar | <PORTAL_APP>\<project>\WEB-INF\lib\

4. Add entries to <PORTAL_APP>\<PROJECT>\WEB-INF\web.xml.
   1. Open <PORTAL_APP>\<PROJECT>\WEB-INF\web.xml.
   2. Open <BEA_HOME>\<WEBLOGIC_HOME>\samples\portal\portalApp\sampleportal\WEB-INF\web.xml.
   3. From the sampleportal web.xml file, copy the following sections into your project web.xml file in the appropriate locations:

      >     <!-- Yahoo Integration: Filter to handle login -->
      >     <filter>
      >         <filter-name>YahooLoginFilter</filter-name>
      >         <filter-class>com.bea.myee.portal.YahooLoginFilter</filter-class>
      >     </filter>
      >         <filter-mapping>
      >             <filter-name>PageFlowJspFilter</filter-name>
      >             <url-pattern>*.jsp</url-pattern>
      >         </filter-mapping>
      >     <!-- Putting this on * will allow it to handle <um:login>,
      >     j_security_check/form-based, and Basic Auth style logins.
      >     -->
      >     <filter-mapping>
      >         <filter-name>PortalServletFilter</filter-name>
      >         <url-pattern>*</url-pattern>
      >     </filter-mapping>

      >     <!-- Yahoo Integration: filter mapping should be the same as
      >          the NetUIx servlet mapping -->
      >     <filter-mapping>
      >         <filter-name>YahooLoginFilter</filter-name>
      >         <url-pattern>*.portal</url-pattern>
      >     </filter-mapping>
      >     <filter-mapping>
      >         <filter-name>YahooLoginFilter</filter-name>
      >         <url-pattern>/appmanager/*</url-pattern>
      >     </filter-mapping>

      >     <listener>
      >         <listener-class>
      >         com.bea.wlw.runtime.core.servlet.WebappContextListener
      >         </listener-class>
      >     </listener>
      >     <!-- PortalServices: Listener to initialize a user's Anonymous profile on
      >          session creation -->
      >     <listener>
      >         <listener-class>com.bea.p13n.servlets.AnonymousProfileListener</listener-class>
      >     </listener>
      >     .
      >     .
      >     .
      >     <!-- Yahoo Integration: Controller Servlet -->
      >     <servlet>
      >         <servlet-name>YahooController</servlet-name>
      >         <servlet-class>com.bea.myee.portal.YahooController</servlet-class>
      >     </servlet>
      >     .
      >     .
      >     .
      >     <!-- Yahoo Integration: Controller Servlet Mapping-->
      >     <servlet-mapping>
      >         <servlet-name>YahooController</servlet-name>
      >         <url-pattern>/yahoo_controller</url-pattern>
      >     </servlet-mapping>

   4. Save and close your web.xml file.
5. Create a portal in your portal Web project. This can be a temporary portal you do not plan to use later. See Creating a Portal File.
6. Add the Login to Portal portlet to your portal. See Login to Portal Portlet in the Portal Samples.
7. In the Data Palette window, drag one of the My Yahoo! Enterprise Edition portlets into the portal. For example, "Company News."
8. Continue with the rest of the instructions in this topic.

To set up a trial account

1. Go to the following URL and sign up for a free Yahoo! MYEE trial:
   http://admin.corporate.yahoo.com/dat/myee_trial?vendor=BEAS&ver=810
   You will receive a deployment number and a deployment key.
2. In the Application window, open the <PORTAL_APP>\data\userprofiles\YahooEnterprise.usr property set.
3. In the Property Set Designer, select the DeploymentNumber property. In the Property Editor window, enter the deployment number you received from Yahoo! in the Value(s) field.
4. In the Property Set Designer, select the DeploymentKey property. In the Property Editor window, enter the deployment key you received from Yahoo! in the Value(s) field.
5. Modify the ModelAccount and AnonymousModelAccount property values to use the default value ma_default.
6. Save and close the property set file.

To activate support for anonymous users

Certain My Yahoo! Enterprise Edition modules can be configured for anonymous users. Use this procedure to activate support for anonymous users. It involves simply logging in to an existing portal using the Login Portlet. You must perform this procedure before you can perform the next procedure.

1. Make sure the server is running. If it is not running, open in WebLogic Workshop, choose Tools-->WebLogic Server-->Start WebLogic Server.
2. In WebLogic Workshop, open the portal you created in the last steps of To add My Yahoo! Enterprise Edition to your portal application.
3. Open the portal in a browser. In the WebLogic Workshop menu, choose Portal-->Open Current Portal.
4. When the portal desktop appears, log in to the Login portlet with the username/password of yahooadmin/yahooadmin.
   Note: The user yahooadmin is the default value for the YahooAdministrator property in the YahooEnterprise.usr property set. If you want to use a different user to activate support for anonymous users, do the following:

- Change the value of the YahooAdministrator property to the username you want.
- Make sure that user is a member of the Administrators user group. (See the WebLogic Administration Portal help system for instructions on adding users to groups.)

5. When prompted to link your portal account with a Yahoo! account, click OK.
6. On the Yahoo! Web page that appears, click Return to portal without linking. The Yahoo! Web page disappears.
7. In the browser containing the portal desktop, click the Refresh button. The My Yahoo! Enterprise Edition content appears.

To set up a model account

A model account lets you set up default configurations for My Yahoo! Enterprise Edition modules that you use in your portals. For example, in a model account you can set the Weather module to display weather for specific cities by default.

1. Access the WebLogic Administration Portal for your application. In the WebLogic Workshop menu, choose Portal-->Portal Administration.
2. At the WebLogic Administration Portal login page, log in with an administrator username and password. This step provides authentication for the next step.
3. Access the My Yahoo! Model Accounts page:
   1. In your browser, enter the following URL: http://<server>:<port>/<project>/yahoo/admin/index.jsp. For example, if your portal Web project is called myPortal, enter http://localhost:7001/myPortal/yahoo/admin/index.jsp.
   2. When the page appears, click Edit Model Accounts. The Corporate Yahoo! Model Account Administration page appears in a new browser window.
4. In the Create a Model Account area, create a model account called ma_default. This matches the ModelAccount and AnonymousModelAccount property values in the YahooEnterprise.usr property set.
5. When the new model account appears in the Edit a Model Account list, click its link and configure the default views of any modules.

You are ready to add preconfigured My Yahoo! Enterprise Edition portlets to your portals. See My Yahoo! Enterprise Edition Portlets for instructions. You can also create new portlets from My Yahoo! Enterprise Edition modules. See Creating Portlets from My Yahoo! Enterprise Edition Modules for instructions.

When users log in for the first time to a portal desktop that contains My Yahoo! Enterprise Edition portlets, they are prompted to link to their existing Yahoo! accounts.

- If they choose the option to return to the portal without linking, they see the My Yahoo! Enterprise Edition portlets in the desktop with the default model account settings you configured, and an automatically generated Yahoo! ID is created for each user in the YahooId property of the YahooEnterprise.usr property set. Any customizations users make to portlets are stored on the My Yahoo! Enterprise Edition server for that automatically generated YahooId. Users will see those customizations whenever they log in to the portal without linking to their My Yahoo! accounts.
  Use the Link Yahoo! Accounts portlet to let users link to their existing My Yahoo! accounts.
- If they do link to their existing My Yahoo! accounts, they see the My Yahoo! Enterprise Portlets with the customized settings they configured in their own My Yahoo! accounts, and an automatically generated Yahoo! ID is created for each user in the YahooId property of the YahooEnterprise.usr property set. Any customizations users make to portlets are stored on the My Yahoo! Enterprise Edition server for their existing My Yahoo! accounts.

## Samples

In the Portal Samples, see My Yahoo! Enterprise Edition Portlets.

Related Topics

Adding My Yahoo! Enterprise Edition to Portal Applications

Creating Portlets from My Yahoo! Enterprise Edition Modules

See the WebLogic Administration Portal help system tutorial on "Setting up My Yahoo! Enterprise Edition Portlets."