查看“LeaderHeads/网页插件”的源代码

{{待完善}}
LeaderHeads 网页插件可以让你在网页上看到玩家的数据记录. 这一插件拥有大量特性且高度可自定义.
===== 网页插件配置 =====

LeaderHeads网页插件旨在让你简单地建立更高级的排行榜而不需要深奥的数据库知识. 

你只需要知道默认数值的概念并修改服务器配置, 那么你就可以很容易地上手. 解释在 ''leaderboard_config.yml'' 和 ''stats_config.yml'' 内.

在配置中的''服务器'' 选项指的是    ''database.yml''里的''服务器''配置. If you want a column or table to sync from for example your SkyWars server, set the ''server'' option in the ''database.yml'' to ''skywars'' and use ''skywars'' as ''server'' in the below configuration files.

''leaderboard_config.yml''
<spoiler><code># 这是排行榜的配置文件.


# 搜索引擎显示的描述.
description: "Leaderboards"

# 浏览器网页显示的标题.
page_title: "Leaderboard"

# 信息
messages:
    # 时间选项. 这些内容会显示在下拉选择菜单内 dropdown select menu.
    alltime: "全服"
    monthly: "本月"
    weekly: "本周"
    daily: "今天"
    # 高位数格式.
    high_formats:
        thousands_format: "千"
        millions_format: "百万"
        billions_format: "B"
        trillions_format: "T"
        quadrillions_format: "QD"
        quintillions_format: "QT"
        sextillions_format: "SX"
        septillions_format: "SP"
    # Time formats
    time_formats: 
        time_format_days: "{days} 天, {hours} 时, {minutes} 分"
        time_format_hours: "{hours} 时, {minutes} 分"
        time_format_minutes: "{minutes} 分"
    
# 显示的板块. 你可以移除或添加板块.
leaderboards:
    # 板块名. 这个名称户会出现在标题.
    "我的服务器":
        # table的行数. 你可以自由修改.
        # 配置按默认的系统运行. 即使用默认的数值.
        # If you didn't specifically set the setting in the config of a column, the default value will be applied.
        # If a value has been set for the table, this value will be applied for all columns where this value isn't set.
        # Explanation of these settings can be found under the defaults section.
        # Tables also use this system, which means that you can specifically set a setting for a certain table.
        columns:
            # 在第一行显示的数据.
            "Time played":
                # 游戏内的数据名.
                type: "played"
                statistic_type: "time"
                width: 13%
            "Kills":
                type: "kills"
            "Deaths":
                type: "deaths"
            "Walked Blocks":
                type: "walk"
            "Balance":
                type: "balance"
                format: "${amount}"
                format_high_numbers: true
            "Level":
                type: "bl-level"
            "Items dropped":
                type: "drop"
        settings:   
            server: default
            count: 20
            enable_search_bar: true
            enable_upper_pagination: true
            enable_lower_pagination: true
            enable_caption: false
            enable_header: true
            enable_column_select: true
            enable_select: true
            enable_index_column: true
    "My second server":
        columns:
            "Kills":
                type: "kills"
            "Deaths":
                type: "deaths"
            "Walked Blocks":
                type: "walk"
            "Balance":
                type: "balance"
                format: "${amount}"
                format_high_numbers: true
        settings:    
            server: default
defaults:
    # 可用的时间间隔.
    available_time_types: ["alltime", "monthly", "weekly", "daily"]
    # 板块宽度.
    table_width: 800px;
    # 显示多少名玩家.
    count: 20
    # 是否启用选择条
    enable_select: true
    # 选择条的内容. 
    # {time} 代表下拉选择菜单的时间.
    # {type} 代表下拉选择菜单的类型.
    select_text: "按 {type} 分类来选择 {time}"
    # 是否在table页面上面显示选择条.
    enable_upper_pagination: true
    # 是否在table页面下面显示选择条.
    enable_lower_pagination: true
    # 选择菜单选择条的页数.
    pagination_size: 10
    # 是否在table上显示搜索条.
    enable_search_bar: true
    # 选择条内信息的占位符变量.
    search_bar_button_placeholder: "Username"
    # 显示在搜索按钮的文字.
    search_bar_button_text: "查找玩家"
    # 搜索跳转的链接.
    search_bar_url: "/player/{name}"
    # Whether a little image of the player's skull should be displayed next to the player's name.
    enable_skull: true
    # 获取皮肤头的地址.
    skull_url: "https://crafatar.com/avatars/{name}"
    # 是否显示一行来链向主页.
    enable_index_column: true
    # 主页行的宽度.
    index_column_width: 6%
    # Text in the header of the index column.
    index_column_text: ""
    # Format of the index column
    index_column_format: "{rank}"
    # Width of the player column.
    player_column_width: 10%
    # 显示玩家名那一行显示的文字.
    player_column_text: "玩家"
    # Whether the table should have a caption or not.    
    enable_caption: false
    # Whether the caption should have custom text instead of the name of the table.
    enable_caption_custom_text: false
    # Custom text of the caption if 'enable_caption_custom_text' is set to true.
    caption_custom_text: "排行榜"
    # Whether the table should have a header or not. The name of this table will be displayed in the header.
    enable_header: true
    # Whether you can press the header of the column to order by that statistic.
    enable_column_select: false
    # Whether you can press on a player's name to go to his profile.
    enable_click_name: true
    # URL that you get redirected to when clicking on the player's name.
    click_name_url: "/player/{name}"
    # 默认行数设置
    columns:
        # 默认行数服务器
        server: default
        # 默认格式.
        format: "{amount}"
        # 默认数据类型. Use 'default' for normal statistics and 'time' for time related statistics.
        statistic_type: "default"
        # Default decimals that should be shown after the decimal point.
        decimals: 0
        # Whether there should be a dot between every 3 digits.
        format_3_digits: false
        # Whether the statistic should be formatted with the values from 'high_formats'.
        format_high_numbers: false
        # Width of this column.
        width: 8%;
        # Whether this column should stay to the time_type from the config, even when the dropdown menu is used
        keep_time_type: false
        # The selected time period of this statistic. Options are 'alltime', 'monthly', 'weekly' and 'daily'.
        time_type: "alltime"
settings:
    # Whether there should be a page header above the tables.
    enable_page_header: true
    # Text of the page header.
    page_header_text: "Leaderboards"
    # Whether there should be a global search bar above the tables.
    enable_global_search_bar: true
    # Placeholder of the text in the global search bar.
    global_search_bar_button_placeholder: "Username"
    # Text in the search button of the global search bar.
    global_search_bar_button_text: "Search Player"
    # URL that the global search bar redirects to.
    global_search_bar_url: "/player/{name}"
</code></spoiler>

''stats_config.yml''
<spoiler><code># This is the configuration file for a personal stats page.


# The description of the page as it appears in a search engine description.
description: "Player stats"

# The title of the page as it appears in the tab of your browser.
page_title: "{name} - Stats"

# Messages
messages:
    # High formats as they appear when enabling 'format_high_numbers'.
    high_formats:
        thousands_format: "k"
        millions_format: "M"
        billions_format: "B"
        trillions_format: "T"
        quadrillions_format: "QD"
        quintillions_format: "QT"
        sextillions_format: "SX"
        septillions_format: "SP"
    # Time formats
    time_formats: 
        time_format_days: "{days} days, {hours} hours, {minutes} minutes"
        time_format_hours: "{hours} hours, {minutes} minutes"
        time_format_minutes: "{minutes} minutes"
    # Last seen time message
    last_seen: 
        year_ago: "%y year ago"
        years_ago: "%y years ago"
        month_ago: "%m month ago"
        months_ago: "%m months ago"
        day_ago: "%d day ago"
        days_ago: "%d days ago"
        hour_ago: "%h hour ago"
        hours_ago: "%h hours ago"
        minute_ago: "%i minute ago"
        minutes_ago: "%i minutes ago"
        just_now: "just now"
        never_joined: "Never joined"
    # Last seen message.
    last_seen_message: "Last seen: {time}"
    # The message that appears instead of the name if the searched player doesn't exist.
    not_exist: "This player does not exist"
    
# Tables that appear as you want. You can remove and add as much tables as you want.
tables:
    # Name of the table. This name appears in the header and the caption if no other text is set.
    "My first server":
        # Rows of the table. You can remove and add as much rows as you want.
        # The configuration works on a default-based system. This means that there's a set amount of default values.
        # If you didn't specifically set the setting in the config of a row, the default value will be applied.
        # Explanation of these settings can be found under the defaults section.
        # Tables also use this system, which means that you can specifically set a setting for a certain table.
        rows:
            # Name of your row as it appears in the first column
            "Kills":
                # The name of the statistic as used in-game
                type: "kills"
            "Deaths":
                type: "deaths"
            "Walked Blocks":
                type: "walk"
            "Balance":
                type: "balance"
                format: "${amount}"
                format_high_numbers: true
        settings:    
            server: default
            table_width: 400px
    "My second server":
        rows:
            "Weekly blocks walked":
                type: "walk"
                time_type: "weekly"
            "Deaths":
                type: "deaths"
            "Level":
                type: "bl-level"
            "Items dropped":
                type: "drop"
        settings:    
            server: default
            table_width: 400px
    "My third server":
        rows:
            "Time played":
                type: "played"
                statistic_type: "time"
            "Blocks mined":
                type: "ez-blocks"
            "Walked Blocks":
                type: "walk"
        settings:    
            server: default
            table_width: 400px
defaults:
    # The width of the table.
    table_width: 400px;
    # Whether the table should have a caption or not.
    enable_caption: false
    # Whether the caption should have custom text instead of the name of the table.
    enable_caption_custom_text: false
    # Custom text of the caption if 'enable_caption_custom_text' is set to true.
    caption_custom_text: "Leaderboard"
    # Whether the table should have a header or not. The name of this table will be displayed in the header.
    enable_header: true
    # Width of the column where the name of the statistic appears.
    index_width: 50%
    # Default row settings
    rows:
        # Default column server
        server: default
        # Default column format.
        format: "{amount}"
        # Default statistic type of a column. Use 'default' for normal statistics and 'time' for time related statistics.
        statistic_type: "default"
        # The selected time period of this statistic. Options are 'alltime', 'monthly', 'weekly' and 'daily'.
        time_type: "alltime"
        # How many decimals should be shown after the decimal point.
        decimals: 0
        # Whether there should be a dot between every 3 digits.
        format_3_digits: false
        # Whether the statistic should be formatted with the values from 'high_formats'.
        format_high_numbers: false
        # Width of the statistic column of this row.
        width: 50%;
        
settings:
    # Whether there should be a page header above the tables.
    enable_page_header: true
    # Text of the page header.
    page_header_text: "Player Statistics"
    # Whether there should be a global search bar above the tables.
    enable_global_search_bar: true
    # Placeholder of the text in the global search bar.
    global_search_bar_button_placeholder: "Username"
    # Text in the search button of the global search bar.
    global_search_bar_button_text: "Search Player"
    # URL that the global search bar redirects to.
    global_search_bar_url: "/player/{name}"
    # Interval in minutes for when a player will be seen as 'just now' online.
    last_seen_interval: 2
    # URL of the player picture that appears.
    player_picture: "https://crafatar.com/renders/body/{name}?overlay=true"
    # Update interval in seconds
    # This will auto update the stats of the player in realtime without refreshing the page
    update-interval: 10
</code></spoiler>
===== 安装网页插件 =====

# -配置你的 database.yml 并连接到 MySQL 数据库. 如果你的服务器有同名的数据的话,推荐使用database.yml内的 'server'选项来区分这些数值 (例如空岛战争的击杀数据和龙蛋战争的击杀数据)
# - 下载网页插件, 打开它并上传至 ''leaderheads'' 文件夹到你的网站根目录下 public_html root. 你可以重命名文件夹.
# - 要想显示数据, 你需要到 ''statistics''文件夹并查找插件数据.打开一个文件并把 ''force-update'' 改为 ''true'' 来确保插件正常发送数据.
# - 在网页插件文件夹''config'的 ''config.php''内配置你的 MySQL.
# - 找到 ''leaderboard.php'' 和/或 ''stats.php''文件来检测是否成功连接数据库.
# - 编辑配置文件夹内的 ''.yml'' follow the comments in the files.
# - 搜索栏和点击名称功能默认关闭. 你需要安装 URL rewrite rules来使用这一特性. 想要了解详情, 请查看 **[https://www.robindebaets.be/wiki/leaderheads_web_add-on/tweaks Rewrite Rules]** 部分.

===== Tweaks =====

==== 改写规则 ====

默认配置下你点击一名排行榜内的玩家你会跳转到易错错误的链接,因为你没有设置正确的地址.
以下为链接的格式:

www.robindebaets.be/leaderboard
www.robindebaets.be/player/RobiRami

== 对于使用 Apache 的网站 ==
Navigate to the ''.htaccess'' file in the public_html root of your website. 
<br />
如果这个文件不存在请手动创建.
把以下内容复制到该文件内.
<code>
# LEADERHEADS BEGIN
RewriteEngine on
Options +FollowSymLinks
RewriteRule ^leaderboard/?$ /leaderheads/leaderboard.php  [L,NC]
RewriteRule ^player/([^/]+)/?$ /leaderheads/stats.php?player=$1 [L,QSA,NC]
# LEADERHEADS END
</code>

== 对于使用 Nginx 的网站==
这里有完全的示例来使用Nginx :  ''/etc/nginx/sites-available/default'' .

<code>
server {
    ...
    rewrite ^/leaderboard/?$ /leaderheads/leaderboard.php;
    rewrite ^/player/([^/]+)/?$ /leaderheads/stats.php?player=$1 last;
    ...
}
</code>

==== 关联你的网站 ====

想要关联排行榜到你的服务器论坛页面内, you can either just add a direct to it or directly integrate it in the website and put your own navigation bar in it.如果你想要直接在你的服务器论坛显示排行榜, 你必须使用 ''iframe''. 以下为示例代码:
<code><iframe src="http://ww.robindebaets.be/leaderheads/leaderboard.php" width="100%" height="300px" scrolling="no" frameborder="0"></iframe></code>

如果你想要显示一名玩家的 Xenforo 简介, 以下为安装步骤. Keep in mind that these stats are currently only name based so this will only work if the Xenforo profile name is the same as his Minecraft username.

在 Xenforo 的控制面板内, 找到 Appearance 并选择 ''Templates'' 模版.
查找 ''member_view'' of your Xenforo theme and go to the editor.
I recommend making a backup first so you don't break your installation.
Search for an 'ul' element with the class "mainTabs". This ''ul'' should contain several ''li'' elements. Add a new ''li'' add the end to make a link to the stats interface.
After changing the code, it should look something like this.

<code><ul class="tabs mainTabs Tabs" data-panes="#ProfilePanes > li" data-history="on">
    ...
    <li><a href="{$requestPaths.requestUri}#stats">{xen:phrase Stats}</a></li>
    ...
</ul></code>

Now that the link is done, we need to add the actual interface.

Search for the ''ul'' with id ''ProfilePanes'', add in a new ''li'' at the end to show the stats interface.
After changing the code, it should look something like this. Make sure to add the correct URL of the the personal stats page.

<code><ul id="ProfilePanes">
    ...
    <li id="stats" class="profileContent">
        <iframe src="http://www.robindebaets.be/player/{$user.username}" width="100%" height="1000px" scrolling="no" frameBorder="0"></iframe>
    </li>
    ...
<ul></code>

If you want to be able to go to a user's Xenforo profile by clicking on his name in the leaderboard, use a Xenforo add-on like [[https://xenforo.com/community/resources/username-url-parameter.3912/| this one]].