dp2OPAC webui.xml 配置指南 - DigitalPlatform/dp2 GitHub Wiki

dp2OPAC 数据目录中的 webui.xml 配置文件,负责配置页面外观方面的各种参数。下面介绍如何进行配置。

如无特别说明,下面示范代码均为片段代码,处在 webui.xml 整个 XML 结构的根元素下方。

libraries 元素 -- 分馆配置

	<libraries>
		<cssMacroTable>
			<item name="%backgroundColor%">#8599a9</item>
		</cssMacroTable>
		<library code="" logoText="城市图书馆">
			<cssMacroTable>
				<item name="%backgroundColor%">#8599a9</item>
			</cssMacroTable>
		</library>
		<library code="海淀分馆" logoText="海淀分馆">
			<cssMacroTable>
				<item name="%backgroundColor%">#cc99a9</item>
			</cssMacroTable>
		</library>
		<library code="西城分馆" logoText="西城分馆">
			<cssMacroTable>
				<item name="%backgroundColor%">#85cca9</item>
			</cssMacroTable>
		</library>
	</libraries>

(2018/10/27-renyh注:logoText属性值为OPAC左上角显示的图书馆名称)

libraries 元素

libraries 元素是个容器元素,其下有若干 library 元素定义分馆,每个 library 元素负责定义一个分馆。

library 元素 (libraries/library)

每个 library 元素负责定义一个分馆。

code 属性 (libraries/library/@code)

library 元素的 code 属性定义分馆的馆代码。总馆的馆代码为空('')。

logoText 属性 (libraries/library/@logoText)

logoText 属性定义(当 dp2OPAC 页面切换到这个分馆时)出现在页面左上角的“我的图书馆” logo 底部的文字。如果只定义了 code 元素而没有定义 logoText 元素,则“我的图书馆” logo 底部文字采用 code 属性值。

style 属性 (libraries/library/@style)

style 属性定义了这个分馆的特殊样式目录。比如 style='海淀分馆' 表示会使用 dp2OPAC 数据目录下 style/海淀分馆 这个子目录来存储各种样式文件,页面优先使用这里的样式文件。

例如我们希望为一个分馆设定专用的页面左上角 logo 图像,可以在这个目录中创建一个 title_logo.gif 文件。(注: logoText 属性定义的 logo 图像底部文字,是 dp2OPAC 在默认的 title_log.gif 文件基础上动态渲染出来的图像)

login 元素 -- 登录界面配置

    <loginControl resetPassword="true" allowBlankPassword="false" />

resetPassword 属性 (loginControl/@resetPassword)

是否在登录界面上出现“找回密码”锚点。缺省为 "false"。注:需要和短信接口配合使用,否则仅出现了锚点是无法使用这个功能的。

allowBlankPassword 属性 (loginControl/@allowBlankPassword)

是否允许读者使用空密码登录?缺省为 "true"。

⚠️ **GitHub.com Fallback** ⚠️