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
commit
4414471100
|
@ -6,6 +6,7 @@ use Friendica\Content\Pager;
|
||||||
use Friendica\Core\Logger;
|
use Friendica\Core\Logger;
|
||||||
use Friendica\Core\Renderer;
|
use Friendica\Core\Renderer;
|
||||||
use Friendica\Database\DBA;
|
use Friendica\Database\DBA;
|
||||||
|
use Friendica\DI;
|
||||||
use Friendica\Model\User;
|
use Friendica\Model\User;
|
||||||
use Friendica\Module\Moderation\Users\Active;
|
use Friendica\Module\Moderation\Users\Active;
|
||||||
|
|
||||||
|
@ -18,6 +19,11 @@ class RatioedPanel extends Active
|
||||||
{
|
{
|
||||||
Active::content();
|
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'] ?? '';
|
$action = $this->parameters['action'] ?? '';
|
||||||
$uid = $this->parameters['uid'] ?? 0;
|
$uid = $this->parameters['uid'] ?? 0;
|
||||||
|
|
||||||
|
@ -111,6 +117,7 @@ class RatioedPanel extends Active
|
||||||
return self::getTabsHTML('ratioed') . Renderer::replaceMacros($t, [
|
return self::getTabsHTML('ratioed') . Renderer::replaceMacros($t, [
|
||||||
// strings //
|
// strings //
|
||||||
'$title' => $this->t('Moderation'),
|
'$title' => $this->t('Moderation'),
|
||||||
|
'$help_url' => $this->baseUrl . '/ratioed/help',
|
||||||
'$page' => $this->t('Behaviour'),
|
'$page' => $this->t('Behaviour'),
|
||||||
'$select_all' => $this->t('select all'),
|
'$select_all' => $this->t('select all'),
|
||||||
'$delete' => $this->t('Delete'),
|
'$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