Kuvaus
Siirry fediversumiin ActivityPubilla ja julkaise blogisi laajemmalle yleisölle! Houkuttele seuraajia, tee päivityksiä ja vastaanota kommentteja ActivityPub-yhteensopivien alustojen monipuoliselta käyttäjäkunnalta.
Kun ActivityPub -lisäosa on asennettu, WordPress-blogisi itse toimii yhdistettynä profiilina yhdessä kunkin kirjoittajan profiilin kanssa. Jos verkkosivustosi on esimerkiksi example.com
, koko blogin profiili löytyy osoitteesta @example.com@example.com
ja kirjoittajat, kuten Janella ja Bobilla olisivat henkilökohtaiset profiilinsa osoitteessa @jane@example.com
ja @bobz@example.com
.
Esimerkki: Annan sinulle Mastodon-profiilini nimen: @pfefferle@mastodon.social
. Teet haun, näet profiilini ja painat seuraa. Nyt kaikki kirjoittamani viestit näkyvät etusivusyötteessäsi. Vastaavasti ActivityPub-laajennuksella voit löytää ja seurata Janen profiilia osoitteessa @jane@example.com
.
Kun seuraat Janen profiilia @jane@example.com
, kaikki hänen sivulla example.com
tekemänsä blogitekstit päätyvät etusivusyötteeseesi. Samanaikaisesti seuraamalla koko blogin profiilia @example.com@example.com
saat päivityksiä kaikilta kirjoittajilta.
Huomaa: jos kukaan ei seuraa kirjoittajaasi tai blogiasi, viestisi jäävät näkymättömiin. Yksinkertaisin tapa tarkistaa laajennuksen toiminta on seurata omaa profiiliasi. Jos sinulla on Mastodon-profiili, aloita seuraamalla siellä uutta profiiliasi.
Lisäosa toimii seuraavien testattujen federoituvien alustojen kanssa, mutta voi olla myös muita alustoja, joiden kanssa se toimii:
- Mastodon
- Pleroma/Akkoma
- friendica
- Hubzilla
- Pixelfed
- Socialhome
- Misskey
- Firefish (ennen nimeltään Calckey)
Muutamia huomioitavia asioita:
- Bloginlaajuinen profiili on yhteensopiva vain sellaisten sivustojen kanssa, joissa uudelleenkirjoitussäännöt (rewrite rules) ovat käytössä. Jos sivustollasi ei ole käytössä uudelleenkirjoitussääntöjä, tekijäkohtaiset profiilit voivat silti toimia.
- Monet yhden tekijän blogit ovat päättäneet sulkea tai ohjata uudelleen kirjoittajaprofiilisivunsa, yleensä SEO-laajennuksella, kuten Yoast tai Rank Math. Tämä tehdään yleensä, jotta vältetään päällekkäinen sisältö blogisi kotisivulla. Jos tekijäsivusi on poistettu käytöstä tällä tavalla, ActivityPub-tekijäprofiilit eivät toimi sinulle. Sen sijaan voit ottaa kirjoittajaprofiilisivusi takaisin käyttöön ja käyttää sitten hakukoneoptimointilisäosassa olevaa vaihtoehtoa tekijäsivun noindexoimiseen. Tämä ratkaisee edelleen päällekkäisen sisällön ongelmat hakukoneiden kanssa ja mahdollistaa ActivityPub-tekijäprofiilien toiminnan.
- Kun ActivityPub on asennettu, vain uudet tulevat viestit ovat saatavilla fediversumissa. Samoin, vaikka olisit käyttänyt ActivityPubia jonkin aikaa, kaikki sivustoasi seuraavat näkevät vain uudet julkaisemasi viestit siitä hetkestä lähtien. He eivät koskaan näe aiemmin julkaistuja viestejä kotisyötteessään. Tämä prosessi on hyvin samanlainen kuin uutiskirjeen tilaaminen. Jos tilaat uutiskirjeen, saat vain tulevat sähköpostit, mutta et vanhoja arkistoituja. ActivityPubin avulla, jos joku seuraa sivustoasi, hän saa siitä lähtien vain julkaisemasi uudet blogikirjoitukset.
Eli miten tämä tehdään?
- Asenna ActivityPub -lisäosa.
- Siirry lisäosan asetussivulle ja säädä asetukset haluamallasi tavalla. Napsauta Tallenna-painiketta, kun olet valmis.
- Varmista, että blogisi kirjoittajan profiilisivu on aktiivinen, jos käytät kirjoittajaprofiileja.
- Mene Mastodoniin tai mihin tahansa muuhun federoituvaan alustaan, etsi profiilisi ja seuraa sitä. Uusi profiilisi on muotoa
@käyttäjänimesi@example.com
tai@example.com@example.com
, joten käytä niitä haussa. - Julkaise uusi kirjoitus blogissasi.
- Tarkista Mastodonista, näkyykö uusi viesti Koti -syötteessäsi.
Huomaa, että voi kestää jopa 15 minuuttia, ennen kuin uusi viesti näkyy yhdistetyssä syötteessäsi. Tämä johtuu siitä, että viestit lähetetään federoituville alustoille viivästetyn cronin avulla. Tämä välttää julkaisuprosessin rikkoontumisen niissä tapauksissa, joissa käyttäjillä saattaa olla paljon seuraajia. Älä siis oleta, että jokin on rikki vain siksi, että et nähnyt sen näkyvän heti. Anna sille aikaa. Useimmissa tapauksissa se tulee näkyviin muutamassa minuutissa, ja sitten tiedät, että kaikki toimii odotetusti.
Blocks
This plugin provides 2 blocks.
- Follow me on the Fediverse Display your Fediverse profile so that visitors can follow you.
- Fediverse Followers Display your followers from the Fediverse on your website.
Asennus
Noudata normaaleja WordPress -lisäosien asennusohjeita.
Automaattinen lisäosan asennus
WordPress-laajennuksen lisääminen sisäänrakennetun laajennuksen asennusohjelman avulla:
- Siirry kohtaan Lisäosat > Lisää uusi.
- Kirjoita Etsi lisäosia -kenttään
activitypub
. - Etsi WordPress-laajennus, jonka haluat asentaa.
- Napsauta Tiedot saadaksesi lisätietoja laajennuksesta ja ohjeet, jotka haluat ehkä tulostaa tai tallentaa laajennuksen määrittämiseksi.
- Asenna WordPress -lisäosa napsauttamalla Asenna nyt.
- Tuloksena oleva asennusnäyttö näyttää asennuksen onnistuneen tai asennuksen aikana havaitut ongelmat.
- Jos onnistuit, klikkaa Aktivoi laajennus sen aktivoimiseksi tai Palaa laajennuksen asennusohjelmaan nähdäksesi lisätoiminnot.
Lisäosan asentaminen manuaalisesti
On muutamia tapauksia, joissa WordPress -lisäosan manuaalinen asentaminen on asianmukaista.
- Mikäli haluat kontrolloida WordPress -lisäosan asennusta ja sen sijaintia.
- Jos serverisi ei salli automaattista WordPress -lisäosan asennusta.
- Jos haluat kokeilla uusita kehitysversiota.
WordPress-laajennuksen manuaalinen asentaminen edellyttää FTP-tuntemusta ja tietoisuutta siitä, että saatat vaarantaa sivustosi, jos asennat WordPress-laajennuksen, joka ei ole yhteensopiva nykyisen version kanssa tai epäluotettavasta lähteestä.
Tee varmuuskopio sivustostasi ennen kuin jatkat.
WordPress -lisäosan manuaalinen asennus:
- Lataa WordPress -lisäosa työpöydällesi.
- Lataa WordPress -kirjastosta
- Lataa GitHub:sta
- Jos latasit zip -tiedoston, pura Plugin -kansio työpöydällesi.
- Lataa Plugin-kansio FTP-ohjelmallasi WordPress-hakemistosi
wp-content/plugins
-kansioon verkossa. - Siirry Lisäosat-näyttöön ja etsi luettelosta juuri ladattu laajennus.
- Valitse Aktivoi ottaaksesi sen käyttöön.
UKK
-
tl;dr
-
Tämä lisäosa yhdistää WordPress-blogisi suosittuihin sosiaalisiin alustoihin, kuten Mastodoniin, mikä tekee julkaisuistasi helpommin saavutettavan laajemmalle yleisölle. Kun lisäosa on asennettu, näiden alustojen käyttäjät voivat seurata sitä, jolloin he voivat vastaanottaa uudet viestisi syötteissään.
-
Tämän lisäosan kehitystilanne?
-
Toteutettu:
- blogin profiilisivut (JSON muodossa)
- kirjoittajaprofiilisivut (JSON muodossa)
- räätälöidyt linkit
- toiminnallinen inbox/outbox
- seuraa (hyväksy seuraaminen)
- jaa artikkeleita
- vastaanota kommentteja/reaktioita
- allekirjoituksen vahvistus
Toteuttaa:
- ketjutettujen kommenttien tuki
- korvaa lyhytkoodit lohkoilla asettelua varten
-
Mikä on ”ActivityPub for WordPress”
-
ActivityPub for WordPress laajentaa WordPressiä joillakin Fediverse-ominaisuuksilla, mutta se ei kilpaile Friendican tai Mastodonin kaltaisten alustojen kanssa. Jos haluat ylläpitää hajautettua sosiaalista verkostoa, käytä Mastodonia tai GNU social.
-
Mitä jos blogisi on alikansiossa?
-
Jotta webfinger toimisi, se on yhdistettävä sen URL-osoitteen juurihakemistoon, jossa blogisi sijaitsee.
Apache
Lisää seuraava .htaccess -tiedostoon juurikansiossa:
RedirectMatch "^\/\.well-known/(webfinger|nodeinfo|x-nodeinfo2)(.*)$" /blog/.well-known/$1$2
Missä ’blog’ on polku alikansioon, jossa blogisi sijaitsee.
Nginx
Lisää seuraavat site.conf -osaan sites-available -osiossa:
location ~* /.well-known { allow all; try_files $uri $uri/ /blog/?$args; }
Missä ’blog’ on polku alikansioon, jossa blogisi sijaitsee.
Arvostelut
Avustajat & Kehittäjät
“ActivityPub” perustuu avoimeen lähdekoodiin. Seuraavat henkilöt ovat osallistuneet tämän lisäosan kehittämiseen.
Avustajat“ActivityPub” has been translated into 23 locales. Kiitoksia kääntäjille heidän työstään.
Käännä “ActivityPub” omalle kielellesi.
Oletko kiinnostunut kehitystyöstä?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Muutosloki
Project maintained on GitHub at automattic/wordpress-activitypub.
1.2.0
- Add: Search and order followerer lists
- Add: Have a filter to defer signature verification
- Improved: ”Follow Me” styles for dark themes
- Improved: Allow
p
andbr
tags only for AP comments - Fixed: Deduplicate attachments earlier to prevent incorrect max_media
1.1.0
- Paranneltu: audio and video attachments are now supported!
- Paranneltu: better error messages if remote profile is not accessible
- Paranneltu: PHP 8.1 compatibility
- Korjattu: don’t try to parse mentions or hashtags for very large (>1MB) posts to prevent timeouts
- Korjattu: better handling of ISO-639-1 locale codes
- Paranneltu: more reliable [ap_author], props @uk3
- Paranneltu: NodeInfo statistics
1.0.10
- Paranneltu: better error messages if remote profile is not accessible
1.0.9
- Korjattu: broken following endpoint
1.0.8
- Korjattu: blocking of HEAD requests
- Korjattu: PHP fatal error
- Korjattu: several typos
- Korjattu: error codes
- Paranneltu: loading of shortcodes
- Päivitetty: caching of followers
- Päivitetty: Application-User is no longer ”indexable”
- Päivitetty: more consistent usage of the
application/activity+json
Content-Type - Poistettu: featured tags endpoint
1.0.7
- Korjattu: broken function call
- Lisätty: filter to hook into ”is blog public” check
1.0.6
- Korjattu: more restrictive request verification
1.0.5
- Korjattu: compatibility with WebFinger and NodeInfo plugin
1.0.4
- Korjattu: Constants were not loaded early enough, resulting in a race condition
- Korjattu: Featured image was ignored when using the block editor
1.0.3
- Korjattu: compatibility with older WordPress/PHP versions
- Päivitys: refactoring of the Plugin init process
- Päivitys: better frontend UX and improved theme compat for blocks
- Yhteensopivuus: add a ACTIVITYPUB_DISABLE_REWRITES constant
- Yhteensopivuus: add pre-fetch hook to allow plugins to hang filters on
1.0.2
- Päivitys: improved hashtag visibility in default template
- Päivitys: reduced number of followers to be checked/updated via Cron, when System Cron is not set up
- Päivitys: check if username of Blog-User collides with an Authors name
- Yhteensopivuus: improved Group meta informations
- Korjattu: detection of single user mode
- Korjattu: remote delete
- Korjattu: styles in Follow-Me block
- Korjattu: various encoding and formatting issues
- Korjattu: (health) check Author URLs only if Authors are enabled
1.0.1
- Päivitys: improve image attachment detection using the block editor
- Päiivitys: better error code handling for API responses
- Päivitys: use a tag stack instead of regex for protecting tags for Hashtags and @-Mentions
- Yhteensopivuus: better signature support for subpath-installations
- Yhteensopivuus: allow deactivating blocks registered by the plugin
- Yhteensopivuus: avoid Fatal Errors when using ClassicPress
- Yhteensopivuus: improve the Group-Actor to play nicely with existing implementations
- Korjattu: truncate long blog titles and handles for the ”Follow me” block
- Korjattu: ensure that only a valid user can be selected for the ”Follow me” block
- Korjattu: fix a typo in a hook name
- Korjattu: a problem with signatures when running WordPress in a sub-path
1.0.0
- Lisäys: blog-wide Account (catchall, like
example.com@example.com
) - Lisäys: a Follow Me block (help visitors to follow your Profile)
- Lisäys: Signature Verification: https://docs.joinmastodon.org/spec/security/
- Lisäys: a Followers Block (show off your Followers)
- Lisäys: Simple caching
- Lisäys: Collection endpoints for Featured Tags and Featured Posts
- Lisäys: Better handling of Hashtags in mobile apps
- Päivitys: Complete rewrite of the Follower-System based on Custom Post Types
- Päivitys: Improved linter (PHPCS)
- Yhteensopivuus: Add a new conditional,
\Activitypub\is_activitypub_request()
, to allow third-party plugins to detect ActivityPub requests - Yhteensopivuus: Add hooks to allow modifying images returned in ActivityPub requests
- Yhteensopivuus: Indicate that the plugin is compatible and has been tested with the latest version of WordPress, 6.3
- Yhteensopivuus: Avoid PHP notice on sites using PHP 8.2
- Korjattu: Load the plugin later in the WordPress code lifecycle to avoid errors in some requests
- Korjattu: Updating posts
- Korjattu: Hashtag now support CamelCase and UTF-8
0.17.0
- Korjaus type-selector
- Salli enemmän HTML-elementtejä Activity-Objects:issa
0.16.5
- Palauta tyhjä sisältö/ote salasanalla suojatuista artikkeleista/sivuista
0.16.4
- Poistettu scripts later in the queue, to also handle scripts added by blocks
- Lisätty published date to author profiles
0.16.3
- ”cc”, ”to”, … fields can either be an array or a string
- Poistettu ”style” and ”script” HTML elements from content
0.16.2
- Korjaus: fatal error in outbox
0.16.1
- Korjaus; ”update and create, posts appear blank on Mastodon” issue
0.16.0
- Add ”Outgoing Mentions” (#213) props @akirk
- Add configuration item for number of images to attach (#248) props @mexon
- Use shortcodes instead of custom templates, to setup the Activity Post-Content (#250) props @toolstack
- Remove custom REST Server, because the needed changes are now merged into Core.
- Korjaus: hashtags (#261) props @akirk
- Change priorites, to maybe fix the hashtag issue
0.15.0
- Enable ActivityPub only for users that can
publish_posts
- Persist only public Activities
- Fix remote-delete
0.14.3
- Better error handling. props @akirk
0.14.2
- Fix Critical error when using Friends Plugin and adding new URL to follow. props @akirk
0.14.1
- Fix ”WebFinger not compatible with PHP < 8.0”. props @mexon
0.14.0
- Friends support: https://wordpress.org/plugins/friends/ props @akirk
- Massive guidance improvements. props mediaformat & @akirk
- Add Custom Post Type support to outbox API. props blueset
- Better hash-tag support. props bocops
- Fix user-count (NodeInfo). props mediaformat
0.13.4
- fix webfinger for email identifiers
0.13.3
- korjaus: Create and Note should not have the same ActivityPub ID
0.13.2
- fix Follow issue AGAIN
0.13.1
- fix Inbox issue
0.13.0
- add Autor URL and WebFinger health checks
- fix NodeInfo endpoint
0.12.0
- use ”pre_option_require_name_email” filter instead of ”check_comment_flood”. props @akirk
- save only comments/replies
- check for an explicit ”undo -> follow” action. see https://wordpress.org/support/topic/qs-after-latest/
0.11.2
- fix inconsistent
%tags%
placeholder
0.11.1
- fix follow/unfollow actions
0.11.0
- add support for customizable post-content
- first try of a delete activity
- do not require email for AP entries. props @akirk
- fix timezones bug. props @mediaformat
- fix digest header bug. props @mediaformat
0.10.1
- fix inbox activities, like follow
- fix debug
0.10.0
- add image alt text to the ActivityStreams attachment property in a format that Mastodon can read. props @BenLubar
- use the ”summary” property for a title as Mastodon does. props @BenLubar
- support authorized fetch to avoid having comments from ”Anonymous”. props @BenLubar
- add new post type: ”title and link only”. props @bgcarlisle
0.9.1
- disable shared inbox
- disable delete activity
0.9.0
- some code refactorings
- fix #73
0.8.3
- fixed accept header bug
0.8.2
- add all required accept header
- better/simpler accept-header handling
- add debugging mechanism
- Add setting to enable AP for different (public) Post-Types
- explicit use of global functions
0.8.1
- fixed PHP warnings
0.8.0
- Moved followers list to user-menu
0.7.4
- added admin_email to metadata, to be able to ”Manage your instance” on https://fediverse.network/manage/
0.7.3
- refactorings
- fixed PHP warnings
- better hashtag regex
0.7.2
- fixed JSON representation of posts https://merveilles.town/@xuv/101907542498716956
0.7.1
- fixed inbox problems with pleroma
0.7.0
- finally fixed pleroma compatibility
- added ”following” endpoint
- simplified ”followers” endpoint
- fixed default value problem
0.6.0
- add tags as hashtags to the end of each activity
- fixed pleroma following issue
- followers-list improvements
0.5.1
- fixed name-collision that caused an infinite loop
0.5.0
- complete refactoring
- fixed bug #30: Password-protected posts are federated
- only send Activites when ActivityPub is enabled for this post-type
0.4.4
- show avatars
0.4.3
- finally fixed backlink in excerpt/summary posts
0.4.2
- fixed backlink in excerpt/summary posts (thanks @depone)
0.4.1
- finally fixed contact list
0.4.0
- added settings to enable/disable hashtag support
- fixed follower list
- send activities only for new posts, otherwise send updates
0.3.2
- added ”followers” endpoint
- change activity content from blog ’excerpt’ to blog ’content’
0.3.1
- better json encoding
0.3.0
- basic hashtag support
- temporarily deactivated likes and boosts
- added support for actor objects
- fixed encoding issue
0.2.1
- customizable backlink (permalink or shorturl)
- show profile-identifiers also on profile settings
0.2.0
- added option to switch between content and excerpt
- removed html and duplicate new-lines
0.1.1
- fixed ”excerpt” in AS JSON
- added settings for the activity-summary and for the activity-object-type
0.1.0
- added basic WebFinger support
- added basic NodeInfo support
- fully functional ”follow” activity
- send new posts to your followers
- receive comments from your followers
0.0.2
- refactoring
- functional inbox
- nicer profile views
0.0.1
- oletusarvoinen