Skip to content
This repository was archived by the owner on Feb 4, 2025. It is now read-only.

Actions and OnChanged events

Alex edited this page Sep 25, 2017 · 10 revisions

This reference table might be slightly out of date. The best place for a completely up-to-date picture of current actions is here.

Accounts (WordPress.com)

Action OnChanged event Description
FETCH_ACCOUNT OnAccountChanged Request fetch of account information
FETCH_SETTINGS OnAccountChanged Request fetch of account settings
SEND_VERIFICATION_EMAIL OnAccountChanged Request verification email for unverified accounts
PUSH_SETTINGS OnAccountChanged Save changes to account settings to the server
CREATE_NEW_ACCOUNT OnNewUserCreated Create new account (can be used to validate the account before creation)
IS_AVAILABLE_BLOG OnAvailabilityChecked Check if a site is available to be registered on WordPress.com
IS_AVAILABLE_DOMAIN OnAvailabilityChecked Check if a domain is available to be registered on WordPress.com
IS_AVAILABLE_EMAIL OnAvailabilityChecked Check if an e-mail address is available to be registered on WordPress.com
IS_AVAILABLE_USERNAME OnAvailabilityChecked Check if a username is available to be registered on WordPress.com
UPDATE_ACCESS_TOKEN OnAuthenticationChanged Update in-memory and persisted Access Token
SIGN_OUT OnAccountChanged + OnAuthenticationChanged Delete persisted Account, reset in-memory Account, delete access token

Authentication

Action OnChanged event Description
AUTHENTICATE OnAuthenticationChanged Attempt to sign in to WordPress.com account
DISCOVER_ENDPOINT OnDiscoveryResponse Discover the API endpoint for a self-hosted site
SEND_AUTH_EMAIL OnAuthEmailSent Send magic link e-mail

Comments

Action OnChanged event Description
FETCH_COMMENTS OnCommentChanged Fetch all comments for site
FETCH_COMMENT OnCommentChanged Fetch single comment for site
CREATE_NEW_COMMENT OnCommentChanged Publish a new comment
PUSH_COMMENT OnCommentChanged Edit an existing comment
DELETE_COMMENT OnCommentChanged Delete a comment from the server
LIKE_COMMENT OnCommentChanged Like a comment
UPDATE_COMMENT OnCommentChanged Update local comment data
REMOVE_COMMENTS OnCommentChanged Remove all locally persisted comments for site
REMOVE_COMMENT OnCommentChanged Remove a locally persisted comment
REMOVE_ALL_COMMENTS OnCommentChanged Remove all locally persisted comments (all sites)

Media

Action OnChanged event Description
FETCH_MEDIA_LIST OnMediaListFetched Fetch all media for site
FETCH_MEDIA OnMediaChanged Fetch single media for site
UPLOAD_MEDIA OnMediaUploaded Upload a media item
CANCEL_MEDIA_UPLOAD OnMediaUploaded Cancel an in-progress media upload
PUSH_MEDIA OnMediaChanged Update properties of existing media file on server
DELETE_MEDIA OnMediaChanged Delete a media item from the server
UPDATE_MEDIA OnMediaChanged Update local media data
REMOVE_MEDIA OnMediaChanged Remove a locally persisted media item
REMOVE_ALL_MEDIA OnMediaChanged Remove all locally persisted media (all sites)

Posts

Action OnChanged event Description
FETCH_POSTS OnPostChanged Fetch all posts for site
FETCH_PAGES OnPostChanged Fetch all pages for site
FETCH_POST OnPostChanged Fetch single post for site
PUSH_POST OnPostUploaded Upload a new post or update an existing one
DELETE_POST OnPostChanged Delete a post from the server
UPDATE_POST OnPostChanged Update local post data
REMOVE_POST OnPostChanged Remove a locally persisted post
REMOVE_ALL_POSTS OnPostChanged Remove all locally persisted posts (all sites)

Sites

Action OnChanged event Description
FETCH_SITES OnSiteChanged Fetch all sites for current WordPress.com site (includes Jetpack sites)
FETCH_SITES_XML_RPC OnSiteChanged Fetch all XML-RPC sites from the given endpoint URL
FETCH_SITE OnSiteChanged Fetch single site information (any API)
CREATE_NEW_SITE OnNewSiteCreated Create new WordPress.com site (can be used to validate the site before creation)
FETCH_POST_FORMATS OnPostFormatsChanged Fetch post formats for site
DELETE_SITE OnSiteDeleted Delete a site (from the server)
EXPORT_SITE OnSiteExported Export site
IS_WPCOM_URL OnURLChecked Check if given URL is a WordPress.com site
UPDATE_SITE OnSiteChanged Update local site data
REMOVE_SITE OnSiteRemoved Remove a locally persisted site
REMOVE_WPCOM_AND_JETPACK_SITES OnSiteRemoved Remove all locally persisted sites for WordPress.com account (includes Jetpack sites)
REMOVE_ALL_SITES OnAllSitesRemoved Remove all locally persisted sites

Taxonomies

Action OnChanged event Description
FETCH_CATEGORIES OnTaxonomyChanged Fetch all categories for site
FETCH_TAGS OnTaxonomyChanged Fetch all tags for site
FETCH_TERMS OnTaxonomyChanged Fetch all terms of a given taxonomy for site
FETCH_TERM OnTaxonomyChanged Fetch single term for site
PUSH_TERM OnTermUploaded Upload a new term to site
UPDATE_TERM OnTaxonomyChanged Update local term data
REMOVE_ALL_TERMS OnTaxonomyChanged Remove all locally persisted terms (all sites)

Uploads (Posts containing uploading Media)

Action OnChanged event Description
CANCEL_POST OnUploadChanged Mark a post that was registered as pending upload as cancelled
CLEAR_MEDIA_FOR_POST OnUploadChanged Clear given media from the list of media associated with a pending post