1 对基于 PC 的 Subscriber Portal 署名

本章介绍如何对 Sun Java System Content Delivery Server 的 Subscriber Portal 组件的 PC 版本进行署名。可以更改下表中所述的任何一个文件或全部文件，以使 Subscriber Portal 界面更加符合公司形象。

表 1-1 Subscriber Portal 文件
文件	描述
`$CDS_HOME/deployment/`deployment-name`/.../tpl/_tpl_main.jsp`¹	每页的旗标和脚注
`$CDS_HOME/deployment/`deployment-name`/localization/SubscriberPortalLocaleResource.properties`	用于标题和其他文本元素的字符串
`$CDS_HOME/deployment/`deployment-name`/.../static/media/t0-banner.gif`¹	用于徽标的图形
`$CDS_HOME/deployment/`deployment-name`/dynamic_banner/modelloggedin.html`	为已指定了设备而且已登录的订户显示的主页
`$CDS_HOME/deployment/`deployment-name`/dynamic_banner/modelnotloggedin.html`	为已指定了设备但尚未登录的订户显示的主页
`$CDS_HOME/deployment/`deployment-name`/dynamic_banner/nomodelnotloggedin.html`	为尚未指定设备且尚未登录的订户显示的主页
`$CDS_HOME/deployment/`deployment-name`/.../styles/subscriber.cs`s¹	用于基本颜色和字体的样式表
`$CDS_HOME/deployment/`deployment-name`/.../layouts/default/user_agreement.html`¹	用户许可协议
¹目录路径因所使用的应用服务器而异：如果使用的是 Sun Java System Application Server，则 Subscriber Portal 文件位于 `$CDS_HOME/deployment/`deployment-name`/sun/domains/`server-domain`/applications/j2ee-modules/CDSSubscriberPortal` 目录中。如果使用的是 WebLogic Server，则 Subscriber Portal 文件位于 `$CDS_HOME/deployment/`deployment-name`/weblogic/domains/`server-domain`/applications/subscriber` 目录中。 deployment-name 是在部署 Vending Manager 时指定的名称；server-domain 是在部署配置文件中为 `app.server.domain` 属性指定的值。

提示 - 表 1-1 中列出的文件用于显示 Subscriber Portal 的页面。刷新页面时将显示更改。您可能希望对文件副本进行编辑，然后在确保没有错误后使用更改后的文件替换原始文件。

本节包括以下主题：

更改旗标

添加脚注

更改标题

更改文本

更改主区域

更改按钮

更改基本颜色和字体

提供用户许可协议

要更改订户从其移动设备访问的 Subscriber Portal 版本，请参见 2。要使用自己的订户界面替换 Subscriber Portal，请参见《Sun Java trademark System Content Delivery Server 5.1 定制指南》中关于订户 API 的信息。

1.1 更改旗标

旗标是在每页顶端显示的图形。默认旗标是包含文字 "Wireless, Inc. " 的蓝条。要更改旗标，请执行以下操作：

1. 打开 $CDS_HOME/deployment/deployment-name/.../tpl/_tpl_main.jsp。

2. 查找字符串 wireless.inc-masthead.gif 并用要使用的图像文件名称替换它。

如果没有对图像进行本地化，请使用图像路径变量 img_url。如果对图像进行了本地化，则使用图像路径变量 localized_image_url。以下代码示例显示了进行本地化的图像的路径。

<td width="377" height="87">
  <img src="<%=img_url%>/wireless.inc-masthead.gif" width="283" height="45">
</td>

3. 保存所做的更改。

4. 存储图像。

如果没有对新的图像进行本地化，则将该图像存储在 $CDS_HOME/deployment/deployment-name/.../static/media 目录中。如果已经对图像进行了本地化，则将该图像存储在为相应语言的 SubscriberPortalLocaleResource.properties 文件中的 localized.path.image_url 属性指定的目录中。

1.2 添加脚注

脚注是在每页底部显示的文本或图形。默认脚注为空白。要添加脚注，请执行以下操作：

1. 编辑 $CDS_HOME/deployment/deployment-name/.../tpl/_tpl_main.jsp。

2. 查找语句 。

3. 将要在每页底部显示的文本或图像添加到表中该行的第二列。

如果没有对图像进行本地化，则使用图像路径变量 img_url。如果对图像进行了本地化，则使用图像路径变量 localized_image_url。以下示例显示了没有进行本地化的图像的路径。

<tr> <!-- BEGIN 3rd Row -->
<td width="1" height="24" bgcolor="#cccccc"><img src=
    "<%=img_url%>/v3_pixel.gif" width="1" height="24" alt="" border="0"></td>
<td colspan="5" height="24">sample copyright statement; all rights reserved
</td>
<td width="1" height="24" bgcolor="#cccccc"><img src=
    "<%=img_url%>/v3_pixel.gif" width="1" height="24" alt="" border="0"></td>
</tr>

4. 存储图像。

如果没有对图像进行本地化，则将该图像存储在 $CDS_HOME/deployment/deployment-name/.../static/media 目录中。如果已经对图像进行了本地化，则将该图像存储在为相应语言的 SubscriberPortalLocaleResource.properties 文件中的 localized.path.image_url 属性指定的目录中。

1.3 更改标题

要更改主页面的标题，则编辑 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件。用要求的标题替换 desktop.common.applicationTitle 属性的值，例如：

desktop.common.applicationTitle=Test Subscriber Portal

如果资源文件特定于具体的语言环境，则在每个文件中设置该属性。

1.4 更改文本

Subscriber Portal 页面上显示的文本是从 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件中读取的。要更改字段的消息或标签，请编辑该文件中的字符串。基于 PC 的 Subscriber Portal 所使用的属性具有 desktop 前缀，例如：desktop.common.applicationTitle。

如果资源文件特定于具体的语言环境，请编辑与所使用的语言环境相应的文件中的字符串。

1.5 更改主区域

修改 $CDS_HOME/deployment/deployment-name/dynamic_banner 目录中的以下文件以更改在主页上为订户显示的内容：

modelloggedin.html - 为登录到 Subscriber Portal 而且已指定了设备的订户显示的页面

modelnotloggedin.html - 为已选择了设备但尚未登录的订户显示的页面

nomodelnotloggedin.html - 为尚未选择设备且尚未登录的订户显示的页面

要更改这些页面，请为每个文件执行以下步骤：

1. 编辑文件并用有效的 HTML 语句替换表中的正文以创建所需页面。

编辑该表时要切记以下几点：

切勿删除 <table> 和 </table> 语句。

所包含的任何文本或图像切勿超过 375 像素。

要引用 $CDS_HOME/deployment/deployment_name/dynamic_banner 目录中的文件，请使用 BANNER_ROOT，例如，<img src="BANNER_ROOT/home1.gif">。

2. 完成更改后，保存文件。

订户下次引用该页面时，将使用文件的新版本。

注 - 使用表在图像旁边显示文本时，一些浏览器对表的不正确处理可能会导致文本和图像重叠。刷新图像通常可以解决此问题。

还可以用其他语言来显示页面：

1. 复制每个文件并将语言代码添加到名称中。

例如，对于法语版的文件，请创建名为 modelloggedin_fr.html 的文件。

2. 根据需要对每个文件进行更改。

3. 编辑每个语言相应的 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件并将以下属性设置为新文件的名称：

desktop.dynamicBanner.model_logged_in

desktop.dynamicBanner.model_not_logged_in

desktop.dynamicBanner.no_model_not_logged_in

1.6 更改按钮

Subscriber Portal 上已本地化的按钮（例如“登录”和“查找”）是 $CDS_HOME/deployment/deployment-name/.../static/media/language-code 目录中的图像。通过替换现有文件，可以使用所选的图像替换这些按钮。要使用其他语言来提供这些按钮，请参见 4.1.3, 提供本地化的模板和图像。

下表介绍了这些按钮及其关联图像。

表 1-2 Subscriber Portal 已本地化的按钮
按钮	文件名	像素大小（宽度 x 高度）
取消	`cancel.gif`	60 x 18
完成	`done.gif`	60 x 18
下移	`MoveDown.gif`	60 x 18
下载	`download.gif`	60 x 18
编辑	`edit.gif`	60 x 18
忘记密码？	`forgetYourPassword.gif`	120 x 18
登录	`login.gif`	60 x 18
注销	`logOff.gif`	60 x 18
消息	`message.gif`	60 x 18
否	`no.gif`	60 x 18
确定	`ok.gif`	60 x 18
购买	`purchase.gif`	60 x 18
兑换礼券	`redeemCoupon.gif`	100 x 18
重置	`reset.gif`	60 x 18
返回目录	`returnToCatalog.gif`	110 x 18
查找	`search.gif`	60 x 18
发送	`send.gif`	60 x 18
注册	`signUp.gif`	60 x 18
上移	`MoveUp.gif`	60 x 18
更新	`update.gif`	60 x 18
更新用户配置	`updateUserProfile.gif`	110 x 18
用户配置	`userProfile.gif`	75 x 18
是	`yes.gif`	60 x 18

Subscriber Portal 上未本地化的按钮（例如箭头按钮）是 $CDS_HOME/deployment/deployment-name/.../static/media/common 目录下的图像。可以使用您选择的图像替换这些按钮。下表介绍了这些按钮及其关联图像。

表 1-3 Subscriber Portal 未本地化的按钮
按钮	文件名	像素大小（宽度 x 高度）
Add a category (>)	`Add.gif`	60 x 18
Add all categories (>>)	`AddAll.gif`	60 x 18
Edit	`edit_1.gif`	20 x 20
Go to first page (\|<)	`pagination_first.gif`	23 x 20
Go to last page (>\|)	`pagination_last.gif`	23 x 20
Go to next page (>)	`pagination_next.gif`	23 x 20
Go to previous page (<)	`pagination_prev.gif`	23 x 20
Remove a category (<)	`Remove.gif`	60 x 18
Remove all categories (<<)	`RemoveAll.gif`	60 x 18

1.7 更改基本颜色和字体

为了简化署名，Subscriber Portal 的布局由样式表 $CDS_HOME/deployment/deployment-name/.../styles/subscriber.css 控制。背景和字体颜色在样式表中进行定义。编辑样式表以更改 Subscriber Portal 的颜色和字体。可以使用任意文本编辑器编辑此文件。

1.8 提供用户许可协议

Subscriber Portal 为许可协议提供了占位符，您可以提供许可协议以指定用户在访问您服务器上的内容并从中下载内容时必须接受的条款。可通过以下方法之一，使用许可协议替换占位符：

用自己的同名文件替换 $CDS_HOME/deployment/deployment-name/.../layouts/default/user_agreement.html 文件。

将 Subscriber Portal 指向其他文件。

如果选择提供不同文件，则编辑 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件并将 desktop.fileInclude.userAgreement 属性值设置为许可协议的位置，例如：

desktop.fileInclude.userAgreement=/legal/cds/terms-conditions.html

许可协议链接的默认文本为 "Wireless, Inc User Agreement"。要更改链接文本，请执行以下操作：

1. 打开 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件。

2. 用要求的字符串替换 desktop.signup.agreementLink 属性的值，例如：

desktop.signup.agreementLink=Terms and Conditions

3. 保存文件。

1

对基于 PC 的 Subscriber Portal 署名