简介

• 自定义静态内容被作为内容类型添加到数据库。他们会显示在结构化区域。
• 在HTML里无布局
• Logo和界面布局以CSS形式添加

自定义界面
添加自定义内容
所有自定义内容都应该通过内容管理器显示在数据库中，通常使用TrivialLangstring和Langstring类型。查看

• ContentDistributionSystem
• doc/auth-server/ContentManagerTutorial

自定义内容和界面元素的逻辑定位
注：下文提到的是系统目前使用的构架布局，但HTML和CSS重构还没有完成。
我们正在从HTML中将同样的布局导向代码移出，所以在CSS中可做的事还是要在CSS中完成。每个页面的结构标识和内容元素都将始终如一的向CSS提供更多的关联信息，并且让样式表更易编写修改。

当内容从网络接口分配出来时，就会具有三个属性：
1.Page:登录页面，门户或其它（其它是指除了登录页面和门户外，还有管理界面和其它页面）
2.Area:图表中灰色分区的ID
3.Display order:在一个区域内的内容显示顺序

更改布局
Stylesheets在wifidog可以做以下应用：
1.默认wifidog stylesheet(默认主题)
2.网络指定的由网络参数选择的stylesheet（网络主题公园）
3.Stylesheet内容类型被添加在内容管理器

使用CSS主题管理器进行样式化
所有网络主题公园都保存在自己的文件夹内，允许分享和用stylesheet来引用图形元素。
使用网络主题公园的优势在于：

• 易于添加图像
• 能够在SVN版本化
• 在服务器上的负载极小
  网络主题公园最多的用于创建网络的大致外观和感觉。你也可以在这更换wifidog logo等。

使用Stylesheet内容类型样式化
使用内容管理器可以添加一个或多个stylesheet snipplets。
使用Stylesheet内容类型的优势在于：
能够被添加到一组热点或者单块内容
能够从网站界面进行编辑
Stylesheet内容类型大多用于暂时更改和定位专一样式化。

自定义UI
内容服务器的静态UI元素
一些重要的界面元素（例如：在线用户列表）已经被重新写成静态内容类型，所以每组可以逐个配置并决定在哪里显示。你可以向空白的门户添加人认为合适的元素。这些元素可以从内容管理器中获得。

动态Smarty模版
你可以使用Smarty语言直接在内容管理器上创建自定义UI元素，并可以从wifidog获得许多稳定的变量（热点名称，登录用户数量等）。当创建SmartyTemplate时可以看到获取完整列表的说明。

本地化
Static strings和gettext
所有static strings能够放在_()内，通过gettext来本地化。如果不支持你的语言，查看doc/developer/LanguageTranslation。
代码提示：

Good: $output=sprintf(('Welcome %s'), $username); Bad:
$output=('Welcome').' '.$username; Very bad: $output=_("Welcome
$username");

内容管理器的文本内容
在Wifidog，所有安装语言都有相对应的文本内容版本。如果精确的语言没有文本的话，Wifidog会：
1.用同样语言显示文本（如：fr_FR或fr）
2.用国家子代码显示文本(如：en_CA)
3.用默认语言显示字符串
显示任何可得字符串

编辑静态模版
Wifidog的所有模版都旨在缓解开发，并不主要是做为自定义工具。它们可以随时更改并且可以在不得已时进行编辑。没有任何机制来要求模版必须用在哪里，而不认可默认设置。将来也不可能有这种机制。
不到万不得已不要编辑模版！这对你没有帮助并且可能会影响项目。如果你想进行一些操作，但又不知道如何进行，那选择下面一项：

• 查询IRC邮件列表应该如何操作
• 用不影响组群的方法修改模版，并提交修改补丁。通常会像创建HTML元素一样简单。
  如果你编辑了模版却没有提交修改，那么你就要负责根据基础模版的变更将它们进行更新。因此，我强烈建议从SVN启动成品服务器，而不是在tarball。这样SVN将会做一部分变更合并工作，并且有冲突提示。

与现有CMS整合
一些组群可能已经有定位感知CMS，他们想继续使用或不想提供任何定位专一内容。鉴于整合水平，已存在系统或网页可以选择一种或两种方法进行整合：
1.使用IFrame内容类型，它会使一个网页作为Wifidog门户的一部显示出来
2.使用SmartyWifidog内容类型，当往目标传递一个些wifidog变量时，可以使一个网页作为wifidog门户的一部分显示出来。
3.使用“URLto show instead of the portal”来完成关闭此热点的Wifidog门户，并且显示一个自定义URL。

与现有认证系统整合
通过扩展认证器的级别，Wifidog已经支持一些外部认证系统。不久，认证器确认了登录界面，创建新用户界面和用户管理部分以后，这个概念就会更加丰富。

本文章由 http://www.wifidog.pro/2015/03/12/wifidog%E9%97%A8%E6%88%B7%E8%87%AA%E5%AE%9A%E4%B9%89.html 整理编辑，转载请注明出处

execSql() : An error occured while executing the following SQL query :
SELECT node_id, last_heartbeat_ip from nodes WHERE last_heartbeat_ip='1.2.3.4' ORDER BY last_heartbeat_timestamp DESC

Error message :
ERROR: relation "nodes" does not exist

execSqlUniqueRes() : An error occured while executing the following SQL query :
SELECT network_id FROM networks WHERE is_default_network=TRUE ORDER BY creation_date LIMIT 1

Error message :
ERROR: relation "networks" does not exist
: Network::getDefaultNetwork: Fatal error: Unable to find the default network! in /var/www/wifidog-auth/wifidog/classes/Network.php on line 101

Postgresql的数据库连接正常和wifidog已存在的数据库，但是最初的SQL结构和数据丢失。

: Unable to connect to database on localhost in /usr/local/apache2/htdocs/wifidog-auth/wifidog/classes/AbstractDbPostgres.php on line 71

• Wifidog未在Postgresql创建的数据库
• 与Postgresql数据库连接失败：错误配置或许可
  Install.php可以帮你解决这一问题并提供更多相关信息。

Le systeme tente de mettre a jour le schema de la base de donnees.
Preparing SQL statements to update schema to version 34

execSqlUpdate(): SQL Query :

BEGIN;


UPDATE schema_info SET value='34' WHERE tag='schema_version';
ALTER TABLE node_stakeholders DROP CONSTRAINT "$1";
ALTER TABLE node_stakeholders ADD CONSTRAINT nodes_fkey FOREIGN KEY (node_id) REFERENCES nodes(node_id) ON UPDATE CASCADE ON DELETE CASCADE;
COMMIT;
VACUUM ANALYZE;

0 rows affected by the SQL query.
Elapsed time for query execution : 0,847244 second(s)

execSqlUpdate(): 0 rows affected by the SQL query.

你的数据库结构没有更新，wifidog门户检测到这个问题，将结构更新到最新版本。如果进行此操作，刷新浏览器时这个提示就会消失。如果再看到这个提示并且又没有更新源代码，结构更新操作可能会失败。

Warning in /classes/Locale.php : Unable to setlocale() to en, return value: , current locale: 
LC_CTYPE=en_US.UTF-8;LC_NUMERIC=C;LC_TIME=C;LC_COLLATE=C;LC_MONETARY=C;LC_MESSAGES=C;
LC_PAPER=C;LC_NAME=C;LC_ADDRESS=C;LC_TELEPHONE=C;LC_MEASUREMENT=C;LC_IDENTIFICATION=C
Warning in /classes/Locale.php : Unable to setlocale() to en, return value: , current locale: 
LC_CTYPE=en_US.UTF-8;LC_NUMERIC=C;LC_TIME=C;LC_COLLATE=C;LC_MONETARY=C;LC_MESSAGES=C;
LC_PAPER=C;LC_NAME=C;LC_ADDRESS=C;LC_TELEPHONE=C;LC_MEASUREMENT=C;LC_IDENTIFICATION=C
Warning in /classes/Locale.php : Unable to setlocale() to en, return value: , current locale: 
LC_CTYPE=en_US.UTF-8;LC_NUMERIC=C;LC_TIME=C;LC_COLLATE=C;LC_MONETARY=C;LC_MESSAGES=C;
LC_PAPER=C;LC_NAME=C;LC_ADDRESS=C;LC_TELEPHONE=C;LC_MEASUREMENT=C;LC_IDENTIFICATION=C
Warning in /classes/Locale.php : Unable to setlocale() to en, return value: , current locale: 
LC_CTYPE=en_US.UTF-8;LC_NUMERIC=C;LC_TIME=C;LC_COLLATE=C;LC_MONETARY=C;LC_MESSAGES=C;
LC_PAPER=C;LC_NAME=C;LC_ADDRESS=C;LC_TELEPHONE=C;LC_MEASUREMENT=C;LC_IDENTIFICATION=C

这个“locale”取决于服务器的配置。在大多数Unix/Linux系统中，可能会用locale –a来列出所有服务器可得语言环境。许多系统对每个国家都有特定的语言环境，所以你需要更改config.php或者local.config.php。例如：将fr改为fr_CA或fr_FR,将en改为en_US或en_GB。

HTML pages contain strange characters ....

修改你的Apache服务器配置文件，并将“AddDefaultCharset on”更改为“AddDefaultCharset utf-8”。

运行install.php脚本的错误提示
关闭错误日志，你可以看到空白页面。
如果你用以下命令打开错误日志：

here's how to turn on php error message display so you can debug problem.

In php.ini (in FC5 most likely located at /etc/php.ini) enable the

error_reporting = E_ALL 
display_errors = On

This will display any error encounter in you browser window. 

错误提示可能是这样的：

Postgresql database connection :
Warning: pg_connect() [function.pg-connect]: Unable to connect to PostgreSQL server: FATAL: Ident authentication failed for user
"wifidog" in /var/www/html/wifidog/install.php on line 1062

这个问题与PostgreSQL安全有关。比较理想的情况是研究一下PGSQL调用的安全系统，但这也会解决这个问题。需要注意的是是否也可能会在不同系统中产生安全问题，这取决于数据库的配置。
编辑pg_hba.conf文件

#TYPE     DATABASE          USER            IP-ADDRESS             SUBNET MASK               METHOD
host      wifidog           wifidog         192.168.0.11           255.255.255.0             md5

当IPF 地址与设备的IP地址吻合时，连接到PGSQL服务器。
重启PGSQL服务器进行新设置。

本文章由 http://www.wifidog.pro/2015/03/12/Wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%B8%B8%E8%A7%81%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA.html 整理编辑，转载请注明出处

内容管理器是WIFIDOG认证服务器最权威也最误解的组成部分。此文档不是内容管理器手册，而是共通使用案例的列单，和作为内容管理器如何去解决。

内容显示脚本
第一部分是简单脚本列表，回答问题“我想这样操作，我该如何操作？”

交替显示图像
1.连接想要显示图像的BannerAddGroup。
2.在“ContentGroup访问控制”将ContentGroup设置成不可再用。
3.将图像做为ContentGroup元素进行添加

在若干(并非全部)热点显示单块内容
这是非常普遍的情况：在所有热点以特定的顺序呈现特定的内容，或者是特定类型的所有热点(咖啡厅，酒吧，图书馆等等)
1.创建一个连接到全网络的可再用内容组
2.将内容作为内容组的第一元素进行添加
3.在“Only display at node(s)”文件添加所需热点

只向用户显示一次单块（或若干块）内容
这些对notices有帮助：
1.连接ContentGroup，添加notice。
2.在“ContentGroup access control”,将ContentGroup设置成不可再用。
3.将notice作为ContentGroup的元素进行添加
4.在“ContentGroup configuration”/“Can content be shown more than once to the same user?”:选择“Content can only be shown once。”

做一次“寻宝”或“串酒吧”
这是给用户提示来寻找下一个位置（和下一个线索）的活动。
1.连接一个新的内容组全网络
2.确保ContentGroup是可再用的
3.将提示作为ContentGroup元素进行添加
4.为每一个将要显示的提示添加热点

处理多个路径
如果你想有多条用户路径或者不全得到相同的提示，操作如下：
1.在“ContentGroup configuration”/“When does the content rotate?”选择“Content rotates each time you change node”。在这种情况下，这意味着内容将不会为单独一个用户循环，这正是我们想要的。
2.确保“In what order should the content displayed?”选择的是“Randomly”。

与另外一个网页或CMS整合
如果能够输入http GET参数，SmartyTemplate内容类型允许经过认证服务器变量到远程服务器。以下例子指出了两个方法。

IRC chat示例使用简单的HTML连接来获取变量
此代码示例允许使用IRC网络接口来直接连接到#wifidog通道。你通常需要手动选择用户名和通道。以下代码会创建一个新连接，此连接将直接将你引导到#wifidog通道，如果你连接到热点，你会告诉其用户你是从哪里连接的。

{if $userName}
<a target='_new' href='http://www.linux-quebec.org/cgi-bin/cgiirc/irc.cgi?interface=nonjs&Nickname={$userName|remove_accents|urlencode}{if $realNodeName}{'|'|urlencode}{$realNodeName|remove_accents|urlencode}{/if}&Realname={$userName|remove_accents|urlencode}{if $realNodeName}{'@'|urlencode}{$realNodeName|remove_accents|urlencode}{/if}&Server={'irc.freenode.net'|urlencode}&Channel={'#wifidog'|urlencode}'>
Chat with wifidog developers</a>

ShoutBox示例使用JavaScript取得变量
此代码将发送用户对另外一个网页的请求，并在新窗口打开。它已经尝试整合ISF的网络。

• 创建ShoutBox
• 在“Shout button ‘onclick=’value”中添加SmartyTemplate。

• 将以下代码粘贴到SmartyTemplate，不用换行

  indow.open('http://www.cwide.org/scripts/cwide_addMsgAndRedirect.php?hotspotID={$realNodeId}&hotspotName={$realNodeName|urlencode}&message='+escape(document.getElementById('shout_text').value)+'&ipAddress={$realNodeLastHeartbeatIP}&username={$userNam|urlencode}');、

本文章由http://www.wifidog.pro/2015/03/12/wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E5%86%85%E5%AE%B9%E7%AE%A1%E7%90%86%E5%99%A8%E6%8C%87%E5%8D%97.html整理编辑，转载请注明出处

内容管理器参考手册

简介
Wifidog允许热点所有者和管理员创建并关联内容到热点登录页面，门户页面或者界面上的任何位置。系统可以通过认证服务器的管理页面访问。最基本的添加/编辑内容的方法是使用Reusable content library。
你可以使用“Add new content”按钮来创建内容。“Show all content”按钮将显示保存在系统中的所有内容。重点要注意的是标准视图将只显示“persistent read-only”内容。在你可以关联内容到热点，网络或者用户预置文件时，内容必须设置成“persistent read-only”。这防止过于容易的删除内容。

内容类型的公共属性
所有内容类型都有几个共通的属性，但是Simple内容类型，例如TrivialLangstring和SimplePicture，可能就没有显示出这一特点来使他们足够简单。

1. Metadata
   不同的Metadata属性包含将要显示给人们的内容的一些信息。这些都有可选性。
   如果使用这些属性，可以构成任何Simple内容类型。因此标题可以是TrivialLangstring，SimplePicture或其它任何可用内容类型。
   需要注意的是如果所有Metadata属性和作者为空的话，内容将以完全不同的形式显示。
   1）标题
   显示内容的标题。注：不存在于Simple类型中，除非他们具有持久性。注：如果检测“是否显示标题？”，则只在显示时出现。检测“是否显示标题？”的原因是是允许给Persistend 内容类型加标题，所以可以在可再用内容库中找到他们，而不用实际显示标题。
   标准显示：将显示在内容区域的最上面
   2）描述
   内容的简短描述。*标准显示：右侧，作者下方
   3）详细描述
   内容的详细描述。将以连接的形式显示真实详细描述的页面。
   4）项目信息
   *标准显示：右侧，描述下方

2. 内容访问控制
   1）是可再用内容库的一部分吗？
   内容是可再用的。可再用的内容将要：显示在可再用内容库，节点和网络内容分配接口。如果不从节点或contentgroup移除将无法删除。No-reusable内容如果从节点，网络或contentgroup移除将完全删除。
   2）内容所有者列表
   当你第一个创建内容时，你就是内容所有者。你可以做为所有者任意添加其它用户，并且用户可以被允许修改内容。
   3）是内容作者吗？
   当你添加一个用户时，你可以检测“Is content author？”来表明用户确实创建了显示的内容。*标准显示：将显示在右上角，在描述上方

不同内容类型
1）需要注意的是以下内容类型都有“Simple”版本，没有metadata属性，没有持久性。从历史原因上讲，SimpleLangtring实际上叫做TrivialLangstring。完全内容类层次。这是内容类型继承层次。内容将完全继承它根源的管理接口，并且可能添加它自己的属性。

ContentGroup
ContentGroup不是真正的内容。它是容纳许多不同内容块的“集装箱”。

ContentGroup配置
它的元素通过以下属性显示：
1）内容显示顺序

• 随机选取内容元素
• 随机选取内容元素，但是要进行两次才显示所有元素
• 按先后顺序选取元素
  2）内容循环
• 内容持续循环
• 内容一天循环一次
• 内容每会话一次循环一次
• 内容每更改节点一次循环一次
  3）内容显示给同一个用户次数
• 内容显示不只一次
• 内容只显示一次
• 内容显示不只一次，但不在一个节点

ContentGroup元素
你可以为每个内容元素新建内容或者选择Reusable Content Library中已存在的内容。请记住：已存在的内容必须在可再用之前设置成持久性。你也可以将内容组分配为彼此的元素，互相嵌套。
每个元素会根据显示环境来显示：

• Display order：元素将以什么顺序显示
• Only display from (date) until (date)：内容将只在这个日期范围内显示。注意的是，一旦过期，元素将默认的不会在管理界面出现。
• Only display at node(s):元素被允许显示的节点。注意的是一个元素可以在任何节点显示，除非选择特定的一个或几个节点。

EmbeddedContent
此内容类型允许你在门户页面嵌入多媒体内容。它支持大量的可靠内容，它会在用户的浏览器不支持多媒体内容的时候显示。

File
此内容类型允许你上传内容，并保存在数据库，或者指定一个可以下载此文件的远程URL，此内容将有一个下载按钮。

Picture
扩展文件，允许显示图片。

FlickrPhotostream
Flickr是数码图片分享页面。这一服务作为图片资源库被广泛应用在博客。Flickr的优点是你可以通过API访问所有图片和metadata。使用API我们可以在WIFIDOG的门户页面上通过Flickr照相排版将图片显示出来。你需要有Flickr API key来激活此内容类型。API key是非商用性的免费使用。我们支持三种图片选择模式：

• 组
• 标签
• 用户

每种选择模式都有许多不同的属性

IFrame
允许在门户的可配置部分显示另外一个网页。

IFrameREST
使用SmartyTemplate更强大

Langstring和TrivialLangstring
人们大多时候都会使用TrivialLangstring。它WIFIDOG指定的所有语方环境的翻译。
注意的是Langstring允许简单的HTML标记。

HTMLeditor
用来创建HTML标记的使用Langstring的WYSIWYG编辑器。

SmartyTemplate
使用Smarty template engine创建源于认证服务器变量的内容。这确实是与其它网络系统整合的最好方法。在管理界面可以获得帮助。

Stylesheet
允许向节点，内容等添加自定义CSS Sylesheets。

RssAggregator
强大的RssAggregator是基于Feedpressreview。在管理界面可以获得帮助。

ShoutBox
注意的是与其它内容类型不同，此内容类型与用户积极互动。它执行Shoutbox的使用案例。它目前拥有最小的特征集：

1. 允许用户直接在门户发送短消息
2. 其它用户可以在门户上看到最后五条信息
3. 它将在允许发送信息之前检测是否与热点连接
4. 允许在按钮鼠标单击添加自定义Javascript,例如将信息复制到远程页面。

本文章由 http://www.wifidog.pro/2015/03/12/wifidog%E8%AE%A4%E8%AF%81%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AE%A1%E7%90%86%E5%99%A8%E6%89%8B%E5%86%8C.html 整理编辑，转载请注明出处