Merge pull request 'Ratioed: add help text' (#1528) from mexon/friendica-addons:mat/ratioed-help into develop
Reviewed-on: https://git.friendi.ca/friendica/friendica-addons/pulls/1528pull/1532/head
Tobias Diekershoff
commit
4414471100
|
|
@ -6,6 +6,7 @@ use Friendica\Content\Pager;
|
|||
use Friendica\Core\Logger;
|
||||
use Friendica\Core\Renderer;
|
||||
use Friendica\Database\DBA;
|
||||
use Friendica\DI;
|
||||
use Friendica\Model\User;
|
||||
use Friendica\Module\Moderation\Users\Active;
|
||||
|
||||
|
|
@ -18,6 +19,11 @@ class RatioedPanel extends Active
|
|||
{
|
||||
Active::content();
|
||||
|
||||
if (isset(DI::args()->getArgv()[1]) and DI::args()->getArgv()[1] === 'help') {
|
||||
$template = Renderer::getMarkupTemplate('/help.tpl', 'addon/ratioed/');
|
||||
return Renderer::replaceMacros($template, array('$config' => DI::baseUrl() . '/settings/addon'));
|
||||
}
|
||||
|
||||
$action = $this->parameters['action'] ?? '';
|
||||
$uid = $this->parameters['uid'] ?? 0;
|
||||
|
||||
|
|
@ -111,6 +117,7 @@ class RatioedPanel extends Active
|
|||
return self::getTabsHTML('ratioed') . Renderer::replaceMacros($t, [
|
||||
// strings //
|
||||
'$title' => $this->t('Moderation'),
|
||||
'$help_url' => $this->baseUrl . '/ratioed/help',
|
||||
'$page' => $this->t('Behaviour'),
|
||||
'$select_all' => $this->t('select all'),
|
||||
'$delete' => $this->t('Delete'),
|
||||
|
|
|
|||
|
|
@ -0,0 +1,92 @@
|
|||
<div class="panel 'help-content-wrapper">
|
||||
<div class="panel-body">
|
||||
<h2>Ratioed Plugin Help</h2>
|
||||
<p>
|
||||
This plugin provides administrators with additional statistics about
|
||||
the behaviour of users. These may be useful as early warning signs
|
||||
that warrant more carefully watching the behaviour of a user. They
|
||||
are <em>not</em> suitable as a trigger for instantly blocking,
|
||||
muting, or reporting a user, since they lack context.
|
||||
</p>
|
||||
<p>
|
||||
The name of the plugin comes
|
||||
from <a href="https://knowyourmeme.com/editorials/guides/what-is-the-ratio-and-what-does-it-mean-to-get-ratioed-twitters-1-rule-explained">"The
|
||||
Ratio"</a>, a well-known quick rule of thumb:
|
||||
</p>
|
||||
<blockquote>
|
||||
If the Replies:RT ratio is greater than 2:1, you done messed up.
|
||||
</blockquote>
|
||||
<p>
|
||||
To "get ratioed" is to receive a large number of comments in a short
|
||||
space of time, with relatively few likes or boosts. If commenters
|
||||
were enthusiastic about the posts, they would also have liked or
|
||||
boosted them. Receiving many comments without such likes or boosts
|
||||
indicates the comments were probably angry. This anger may or may
|
||||
not be justified, but either way this is probably something
|
||||
moderators should be aware of.
|
||||
</p>
|
||||
<p>
|
||||
This plugin allows viewing of an actual ratio, calculated over the
|
||||
last 24 hours. This is a useful timeframe for sudden dogpiling
|
||||
events that administrators might not otherwise notice. The plugin
|
||||
also calculates other statistics.
|
||||
</p>
|
||||
<h3>Explanation of Statistics</h3>
|
||||
<h4>Blocked by</h4>
|
||||
<p>
|
||||
This summarises the number of users on remote servers that have
|
||||
blocked this user.
|
||||
</p>
|
||||
<p>
|
||||
Note that the ActivityPub spec expressly says that
|
||||
implementations "SHOULD NOT" forward such block messages to
|
||||
remote servers. Nevertheless some implementations do this
|
||||
anyway, notably Mastodon. This statistic can only count block
|
||||
messages from servers that do this, as well as blocks from local
|
||||
users. As such, it is usually an undercount.
|
||||
</p>
|
||||
<p>
|
||||
The reason the spec recommends against forwarding these messages
|
||||
is that they can lead to retaliation. For this reason, this
|
||||
plugin deliberately does not provide any way to investigate
|
||||
exactly who blocked the user.
|
||||
</p>
|
||||
<h4>Comments last 24h</h4>
|
||||
<p>
|
||||
This gives the number of comments made on the top-level posts that
|
||||
this user made within the last 24 hours.
|
||||
</p>
|
||||
<h4>Reactions last 24h</h4>
|
||||
<p>
|
||||
This collects the number of likes, boosts, or other "one-click"
|
||||
interactions made on the user's top-level posts within the last 24
|
||||
hours.
|
||||
</p>
|
||||
<h4>Ratio last 24h</h4>
|
||||
<p>
|
||||
This is the ratio between "Comments last 24h" and "Reactions last
|
||||
24h". It is intended to approximate the traditional ratio as
|
||||
understood on Twitter.
|
||||
</p>
|
||||
<h3>Performance</h3>
|
||||
<p>
|
||||
The statistics are computed from scratch each time the page loads.
|
||||
It's possible that this might put a heavy load on the database. and
|
||||
the page may take a long time to load.
|
||||
</p>
|
||||
<h3>Extending</h3>
|
||||
<p>
|
||||
Suggestions for additional statistics are welcome, especially from
|
||||
moderators. This plugin should be considered a sandbox for
|
||||
experimentation, so it is not necessary to prove that any statistic
|
||||
is correlated with unwanted behaviour.
|
||||
</p>
|
||||
<p>
|
||||
However, this plugin does deal with potentially sensitive
|
||||
information. Even if moderators do in principle have access to all
|
||||
information, it should not necessarily be highlighted. Statistics
|
||||
should be kept anonymous and neutral. Also, they should be
|
||||
presented only to moderators, not to the users themselves.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
Loading…
Reference in New Issue