进阶 yourls.org 2026-11-19 17:39:56 · 8 阅读

第24章 YOURLS Pages 功能:创建自定义页面

Pages

YOURLS 有一个鲜为人知却很实用的功能,可以把用户引导到你自创的内容:Pages(页面)。

什么是"Page"?

Page 是一段支持 PHP、也能调用 YOURLS 功能的自定义内容。 比如可以看看 yourls.org/examplepage,源码在:github.com/YOURLS/YOURLS/blob/master/user/pages/examplepage.php 这是一种创建简单页面(团队介绍、公司信息等)的便捷方式,而且可以像 YOURLS 生成的短链接一样访问它们。

如何创建一个 Page

  1. 在 user/pages/ 目录下新建一个 PHP 文件,比如 about.php
  2. 在文件里写入内容(HTML、PHP 代码、YOURLS 相关代码都可以)
就这么简单。现在你可以通过 https://yoursite/about 访问这个页面了(注意没有 .php 后缀)。

"我的 pages/ 目录在 YOURLS 根目录下,不在 user/ 里!"

旧版本的 YOURLS 把 pages 目录放在根目录下。你只需把这个目录移到 user/pages/ 文件夹里,一切就能正常工作。 如果你出于某些原因想把页面保留在根目录(比如页面太多,不想挨个修改硬编码的 include() 路径),可以安装这个简单的插件来实现向后兼容。

Page 示例

我们来做一个简单的统计页面,就像 yourls.org/somestats 那样。 首先,新建一个名为 somestats.php 的文件,放到 user/pages/ 目录下。 在这个文件里粘贴以下代码: // 确保处于 YOURLS 上下文中
if( !defined( 'YOURLS_ABSPATH' ) ) {
die('oops');
}

yourls_html_head( 'statspage', 'YOURLS stats' );
yourls_html_logo();
?>

Some stats here



$stats = yourls_get_stats('top', 5);
printf('

We have %s short urls and a total of %s clicks

',
yourls_number_format_i18n( $stats['stats']['total_links'] ),
yourls_number_format_i18n( $stats['stats']['total_clicks'] )
);
?>

The 5 most clicked URLs are:



    foreach($stats['links'] as $url) {
    printf('
  • %s: %s clicks (%s)
  • ',
    $url['shorturl'],
    basename($url['shorturl']),
    yourls_number_format_i18n($url['clicks']),
    yourls_trim_long_string($url['title'])
    );
    }
    ?>


The 5 most recent URLs are:



    $stats = yourls_get_stats('last', 5);
    foreach($stats['links'] as $url) {

    The 5 most active short URLs during the last 24 hours were:

      fetchObjects($sql); foreach($results as $url) { printf('
    • %s: %s clicks
    • ', yourls_link($url->shorturl), $url->shorturl, yourls_number_format_i18n($url->total) ); } ?>

评论 (0)