lukasros / phpadnsite
个人网站,用于显示app.net的帖子。
Requires
- php: >=5.3.0
- guzzle/http: v3.7.4
- mf2/mf2: v0.2.10
- michelf/php-markdown: 1.5.0
- silex/silex: 1.0.*
- twig/twig: v1.12.1
This package is not auto-updated.
Last update: 2024-09-28 16:31:02 UTC
README
重要通知
app.net已停止运营,此软件不再以实时模式工作。然而,它可以用于提供以前创建的app.net帖子存档。文档将更新以反映这一点。
这是什么?
phpADNSite是一个工具,允许您以自己的视觉风格,在自己的域名上展示您在社交网络骨干app.net上的微博帖子及对话。phpADNSite作为app.net生态系统的一部分的想法部分受到Tumblr的启发,Tumblr将统一的流和帖子界面——您的现有app.net客户端——与完全可定制的博客布局——phpADNSite相结合。
连接到网络并保留您的内容
phpADNSite也是app.net用户参与独立网络(在广义上是最广泛意义上的PESOS)和通过RSS进一步将帖子同步到其他网络(如Twitter和Facebook)的绝佳方式。由于每个app.net帖子都有您域名的永久链接,您可以将phpADNSite替换为您的帖子静态副本,以防app.net崩溃或您决定离开网络,现有的链接不会中断。
phpADNSite默认主题中的所有帖子都包含microformats2和RDFa标记,以及schema.org和Open Graph Protocol。
要求
要运行phpADNSite,您需要一个安装了PHP 5.3或更高版本(包括curl和多字节支持)的web服务器,并且能够进行URL重写。除非您使用需要持久性的插件(目前没有),否则不需要数据库。
设置方法
- 在终端中创建一个目录以安装phpADNSite,并切换到该目录。
- 运行以下命令以下载phpADNSite及其依赖项:
composer create-project "lukasros/phpadnsite" . dev-master
- 使用streams和update_profile权限获取个人访问令牌。您可以在app.net上创建自己的应用程序并生成令牌,或者可以使用dev-lite。
- 将
config.php.template
复制到config.php
并编辑config.php
。将域名数组中的example.com替换为您想要使用的域名,并在username字段中输入您的用户名(不带@),在access_token字段中输入您在上一步骤中生成的访问令牌。 - 将源代码上传到任何web服务器。如果您使用的是较旧的Apache版本,您可能需要将
.htaccess
替换为.htaccess.alt
,如果您使用的是不同的web服务器,您必须手动配置URL重写。 - 在浏览器中打开您web服务器的URL。您应该看到您最新的帖子。恭喜您!
或者,您还可以使用phpADNSite Docker容器。
联盟
当phpADNSite显示其他用户时,例如因为他们重新发布了/收藏了您的帖子或您重新发布了他们的帖子,默认情况下会有一个指向他们的个人资料的链接,该链接指向app.net Alpha微博客户端。然而,如果该用户也在运行phpADNSite(或兼容的软件),则链接可以直接指向他们域名的个人网站!这被称为app.net联盟,并且可以轻松设置。
- 验证设置是否完成,并查看
http://yourdomain/
是否显示您最近发布的帖子。只有当 yourdomain 是公开域且位于面向公众的服务器上时,才能继续操作。 - 打开以下URL:
http://yourdomain/setup/federation
。您应该看到此消息:用户配置文件已配置为使用该域进行app.net联盟。 - 没有第三步。很简单,不是吗?!
实施细节
实施基本上是app.net API和用Twig编写的模板之间的一层薄层,以及一个PHP类插件系统,它允许对帖子进行预处理,例如使用注解。它基于Silex框架。所有内容都从app.net API提供,没有数据库或其他持久层。您可以通过映射不同的(子)域名来为多个用户运行一个实例。
联盟的工作方式如下:phpADNSite在app.net上为您的个人资料添加一个自定义注解,该注解指向您的域。在处理显示的帖子和使用者时,phpADNSite读取该注解并自动渲染正确的链接。
您可以使用自己的插件和模板扩展phpADNSite。
是谁在背后?
phpADNSite是由Lukas Rosenstock创建的,他在app.net上的用户名是@lukasros,并在lukasrosenstock.net上运行phpADNSite的副本来管理自己的微型博客。查看贡献者列表。
如果您想表示感谢,为什么不给我一个Flattr呢?:)
条款
本软件根据AGPL发布 - 详细信息请参阅LICENSE文件。