Hooks Reference

Hooks Reference

Every action and filter Learnomy fires, grouped by the part of the plugin that fires it. Use it to find the hook for a job; the feature pages explain the common ones in context.

575 hooks: 357 filters and 218 actions. This page is generated from the code by bin/gen-hooks-reference.php; do not edit it by hand.

Arguments are shown as the call passes them, after the hook name. For a filter the first argument is the value you return. “Fired in” is the first place the hook is called; a number in brackets means it is called from that many places.

Adapters

Hook	Type	Arguments	What it is for	Fired in
learnomy_checkout_purchase_types	filter	array()	The checkout purchase types that extensions register, keyed by type.	includes/adapters/class-purchase-types.php:61
learnomy_default_gateway_order	filter	array( 'woocommerce', 'stripe', 'paypal', 'test' )	Preference order for surfaces that show one Pay button rather than a.	includes/adapters/class-adapter-registry.php:98
learnomy_membership_invoice_paid	action	(int) $sub->id, $provider_sub_id	Fires after a renewal invoice for a Stripe membership subscription has been recorded.	includes/adapters/class-stripe-adapter.php:1688
learnomy_natively_provisioned_purchase_types	filter	array_merge( \Learnomy\Models\Transaction::course_sale_types(), array( 'membership', 'm...	Filter the purchase types adapters provision themselves.	includes/adapters/class-adapter-registry.php:425
learnomy_payment_failed	action	(string) ( $event->data->object->id ?? '' ), 'stripe', 'async_payment_failed'	Fires when a Stripe Checkout session completes without payment being collected, so no.	includes/adapters/class-stripe-adapter.php:1046 (2)
learnomy_paypal_subscription_updated	action	(int) $sub->id, $resource->status ?? '', $resource	Fires when PayPal reports a subscription update that Free does not act on, such as a plan.	includes/adapters/class-pay-pal-adapter.php:1442
learnomy_purchase_billing_interval	filter	$raw, $type, $item_id	Schedule for a purchase type this adapter does not know natively.	includes/adapters/class-woo-commerce-adapter.php:2050
learnomy_register_payment_adapters	action		Fires after the built-in gateways are registered.	includes/adapters/class-adapter-registry.php:387
learnomy_stripe_invoice_orphan	action	$provider_sub_id, $invoice	Fires when a paid Stripe invoice arrives for a subscription Learnomy has no record of.	includes/adapters/class-stripe-adapter.php:1592 (2)
learnomy_stripe_subscription_updated	action	$subscription, $membership	Stripe customer.subscription.updated event. Fires for every.	includes/adapters/class-stripe-adapter.php:2017
learnomy_stripe_webhook_event	action	(string) $event->type, $event	Fires for every verified Stripe webhook event, after the core.	includes/adapters/class-stripe-adapter.php:1116
learnomy_subscription_	action	. $hook . '_raw', (string) $wc_sub->get_id(), $payload, 'woocommerce'	Fires for a WooCommerce subscription lifecycle event. The dynamic portion of the hook name,.	includes/adapters/class-woo-commerce-adapter.php:1651
learnomy_subscription_cancelled_raw	action	$provider_sub_id, $resource, 'paypal'	Generic cancellation - see the note in handle_subscription_renewed().	includes/adapters/class-pay-pal-adapter.php:1257 (2)
learnomy_subscription_payment_failed_raw	action	$provider_sub_id, $resource, 'paypal', $event_ts	Generic payment failure - see the note in handle_subscription_renewed().	includes/adapters/class-pay-pal-adapter.php:1287 (2)
learnomy_subscription_renewed_raw	action	$provider_sub_id, $sale, 'paypal'	Generic subscription lifecycle event, fired for EVERY recurring.	includes/adapters/class-pay-pal-adapter.php:1338 (2)

Admin

Hook	Type	Arguments	What it is for	Fired in
learnomy_admin_commerce_menu_icon	filter	'dashicons-cart'	The icon of the Commerce top-level admin menu.	includes/admin/class-admin.php:459
learnomy_admin_commerce_menu_items	action		Fires after Learnomy’s own Commerce submenus are registered, so extensions can add theirs.	includes/admin/class-admin.php:542
learnomy_admin_commerce_menu_label	filter	__( 'LMS Commerce', 'learnomy' )	The label of the Commerce top-level admin menu.	includes/admin/class-admin.php:453
learnomy_admin_course_detail_actions	action	(int) $course->id	Pro extension point for per-course actions in the overview header.	includes/admin/views/course-detail.php:95
learnomy_admin_course_detail_panels	action	(int) $course->id	Fires at the bottom of the admin course detail screen, so extensions can add panels.	includes/admin/views/course-detail.php:580
learnomy_admin_dashboard_after_stats	action	$stats	Fires below the stat cards on the admin dashboard. Only fired for site owners, not.	includes/admin/views/dashboard.php:134
learnomy_admin_filter_options_cap	filter	200		includes/admin/class-admin.php:3185 (9)
learnomy_admin_hidden_submenu_targets	filter	$targets	Allow Pro / third-party code to hide additional submenu pages.	includes/admin/class-admin.php:1482
learnomy_admin_init	action	$this	Fires at the end of the admin controller’s init, after Learnomy’s own admin hooks are.	includes/admin/class-admin.php:102
learnomy_admin_instructor_detail_actions	action	(int) $instructor_id	Pro extension point for per-instructor actions, rendered in the.	includes/admin/views/instructor-detail.php:116
learnomy_admin_menu_icon	filter	\Learnomy\logo_menu_icon()	The icon of the top-level Learnomy admin menu.	includes/admin/class-admin.php:119
learnomy_admin_menu_items	action		Fires after Learnomy’s own admin submenus are registered, so extensions can add theirs.	includes/admin/class-admin.php:374
learnomy_admin_menu_label	filter	__( 'Learnomy', 'learnomy' )	The label of the top-level Learnomy admin menu.	includes/admin/class-admin.php:113
learnomy_admin_menu_section_map	filter	$groups, $parent	Filter the slug -> section-key map for a menu. $parent says which menu.	includes/admin/class-admin.php:1263
learnomy_admin_menu_sections	filter	$group_order, $parent	Filter the ordered section-key -> label list for a menu. Controls both.	includes/admin/class-admin.php:1272
learnomy_admin_pro_features_after_categories	action		Fires after the feature categories on the Pro Features admin page.	includes/admin/views/pro-features.php:301
learnomy_admin_pro_features_before_categories	action		Fires before the catalog grid on the Pro Features page.	includes/admin/views/pro-features.php:154
learnomy_admin_settings_menu_icon	filter	'dashicons-admin-settings'	The icon of the Settings top-level admin menu.	includes/admin/class-admin.php:573
learnomy_admin_settings_menu_items	action		Pro / third-party config pages can register under the Settings menu.	includes/admin/class-admin.php:697
learnomy_admin_settings_menu_label	filter	__( 'LMS Settings', 'learnomy' )	The label of the Settings top-level admin menu.	includes/admin/class-admin.php:567
learnomy_admin_settings_nav	action		Fires after the built-in navigation items of the Settings screen, so extensions can add nav.	includes/admin/views/settings.php:395
learnomy_admin_settings_nav_groups	filter	$nav_groups	Register a settings tab into one of the groups above.	includes/admin/views/settings.php:195
learnomy_admin_settings_sections	action		Fires after the built-in Settings sections, so extensions can render additional sections.	includes/admin/views/settings.php:3136
learnomy_admin_status_labels	filter	$labels	Filter the admin status slug → translated label map.	includes/admin/class-ux.php:156
learnomy_admin_status_variants	filter	$map	Filter the admin status → badge-variant map.	includes/admin/class-ux.php:90
learnomy_admin_student_detail_actions	action	(int) $user->ID	Pro extension point for per-student actions (e.g. “Add to Space”.	includes/admin/views/student-detail.php:77
learnomy_admin_subscription_detail_actions	action	$sub_id	Pro extension point for per-subscription actions in the header.	includes/admin/views/subscription-detail.php:64
learnomy_admin_subscription_detail_panels	action	$sub_id, (int) ( $subscription->user_id ?? 0 )	Pro extension point for extra CONTENT panels below the payments table.	includes/admin/views/subscription-detail.php:281
learnomy_admin_transaction_detail_actions	action	$txn_id	Pro extension point for per-transaction actions in the header.	includes/admin/views/transaction-detail.php:76
learnomy_certificate_instructor_choice_limit	filter	500	The maximum number of instructors listed in the certificate rule’s Specific instructors.	includes/admin/class-admin.php:4970
learnomy_commerce_card_descriptions	filter	array( 'learnomy-memberships' => __( 'Plans, pricing, and access tiers.', 'learnomy' ),...	The one-line descriptions shown on the Commerce overview cards.	includes/admin/views/commerce-overview.php:40
learnomy_course_editor_fields	action	$course ?? null	Renders extra course-editor fields in the sidebar so integrations.	includes/admin/views/course-form.php:589
learnomy_course_form_show_pricing	filter	$kernel->is_enabled( 'payments' ) || $kernel->is_enabled( 'membership' ), $course ?? null	Whether the course editor shows the pricing panel.	includes/admin/views/course-form.php:231
learnomy_demo_seed_pro	action	$manifest['course_ids'] ?? array()	Fires during demo seeding so Pro extensions can seed their own demo fixtures.	includes/admin/ajax/class-demo-seeder.php:222
learnomy_demo_seeder_cascade_cleanup	action	$user_ids, $course_ids	Fires after the core cascade sweep so add-ons can purge their own.	includes/admin/ajax/class-demo-seeder.php:638
learnomy_editorjs_tools	filter	array()	Open extension seam - it is the owner’s site, so we never gate what an.	includes/admin/class-admin.php:6117
learnomy_email_merge_tags	filter	$lrn_email_tags, (string) $type_key		includes/admin/views/settings.php:2557
learnomy_force_commerce_menu	filter	false	Allow Pro / third-party code to force the Commerce menu visible.	includes/admin/class-admin.php:437 (2)
learnomy_grading_row_actions	filter	$lrn_grade_row_actions, $lrn_row		includes/admin/views/quiz-grading.php:237
learnomy_integrations_cards	action			includes/admin/views/settings.php:3122
learnomy_is_pro	filter	defined( 'LEARNOMY_PRO_VERSION' )	Whether Learnomy Pro counts as active on the Earnings screen, which gates its Pro-only.	includes/admin/views/earnings.php:269 (4)
learnomy_learning_standards	filter	array( 'xapi' => array( 'name' => __( 'xAPI', 'learnomy' ), 'icon' => 'activity', 'summ...	The canonical learning-standards catalogue. Each entry is one standard the.	includes/admin/views/partials/integrations-hub.php:31
learnomy_lesson_content_editor	action	$current_content_type, $is_edit && $lesson ? (int) $lesson->id : 0	Render seam for a Pro-registered content-type’s editor panel.	includes/admin/views/lesson-editor.php:574
learnomy_lesson_editor_fields	action	$is_edit && $lesson ? $lesson : null	Renders extra lesson-editor fields (and sub-lesson, same editor) so.	includes/admin/views/lesson-editor.php:734
learnomy_lesson_editor_routes	filter	array( 'course-editor' )	Front-end routes that host a client-rendered lesson editor.	includes/admin/class-lesson-attachments-panel.php:123
learnomy_lesson_has_release_schedule	filter	false, (int) $lesson->id	Does this lesson also carry a Pro release schedule?.	includes/admin/views/lesson-editor.php:820
learnomy_lesson_release_settings	action	$is_edit && $lesson ? (int) $lesson->id : 0	Release / drip scheduling panel injection point.	includes/admin/views/lesson-editor.php:896
learnomy_membership_plan_after_form	action	$lrn_plan_id ?? 0	Render extra panels below the membership-plan editor form (e.g. an.	includes/admin/views/membership-edit.php:479
learnomy_membership_plan_space_options	filter	array()	Space scope. Free owns this column and Pro decides what can go in it,.	includes/admin/views/membership-edit.php:399
learnomy_module_gate_enabled	filter	$enabled, $gate_key	Final say on whether a gated admin page’s owner is active.	includes/admin/class-admin.php:846
learnomy_module_gate_label	filter	$module_label, $module	Plain-English name for the thing that gates the page. Free resolves.	includes/admin/class-admin.php:1008
learnomy_module_gated_admin_slugs	filter	$map	Admin pages that disappear when their gating module is switched off.	includes/admin/class-admin.php:824
learnomy_module_gated_page_labels	filter	$slug_labels	Plain-English names for gated pages, so the recovery notice says what.	includes/admin/class-admin.php:997
learnomy_nav_menu_pages	filter	$pages	Filter the list of Learnomy pages exposed in the nav-menus metabox.	includes/admin/class-nav-menu-metabox.php:132
learnomy_notice_resurface_days	filter	$days, $key	Filter the re-surface window for one notice.	includes/admin/class-notice-dismissal.php:179
learnomy_onboarding_steps	filter	$steps	The steps of the onboarding checklist.	includes/admin/class-onboarding-state.php:178
learnomy_pro_course_builder_ai_slot	action	(int) $course->id	AI authoring slot - the Pro ai-authoring extension renders its.	includes/admin/views/course-builder.php:48
learnomy_pro_course_create_ai_slot	action		Fires on the new-course admin screen, where Pro renders its AI course creation entry point.	includes/admin/views/course-form.php:100
learnomy_pro_docs_slugs	filter	self::DOCS_SLUGS	Filter the catalog-slug => docs-slug map, so a site (or a future.	includes/admin/class-pro-links.php:137
learnomy_pro_link_utm	filter	$args, $url, $campaign, $content	Filter the tracking parameters added to a Learnomy marketing link.	includes/admin/class-pro-links.php:97
learnomy_pro_quiz_editor_ai_slot	action	(int) $quiz->id, (string) ( $quiz->title ?? '' )	AI authoring slot - the Pro ai-authoring extension renders its.	includes/admin/views/quiz-editor.php:222
learnomy_pro_tools_card_groups	filter	array( 'teaching' => __( 'Teaching', 'learnomy' ), 'progress' => __( 'Skills & progress...	Section headings for the hub, in render order.	includes/admin/views/pro-tools-hub.php:70
learnomy_pro_tools_cards	filter	array()	The cards on the Pro Tools hub. Used here to work out which extension pages belong under the.	includes/admin/class-admin.php:1622 (2)
learnomy_quiz_editor_advanced_panel	action	(int) $quiz->id	Pro seam - advanced authoring for a saved quiz.	includes/admin/views/quiz-editor.php:872
learnomy_quiz_editor_fields	action	$quiz ?? null	Renders extra quiz-editor fields so an integration can add its own.	includes/admin/views/quiz-editor.php:883
learnomy_quiz_grading_response_controls	action	$lrn_row['response'], $attempt, $lrn_row['question']	Fires after the manual grading controls of a response on the quiz grading detail screen. The.	includes/admin/views/quiz-grading-detail.php:227 (2)
learnomy_sanitize_settings	filter	$clean, $raw	The sanitized Learnomy settings, filtered before they are saved.	includes/admin/class-admin.php:2399
learnomy_settings_pages_registry	filter	$frontend_pages	Allow Pro extensions to register additional public pages in the Pages.	includes/admin/views/settings.php:333
learnomy_settings_schema	filter	$schema	Filter the settings schema.	includes/admin/class-admin.php:2026
learnomy_unknown_instructor_label	filter	get_bloginfo( 'name' ), $course	The label shown in the admin courses list for a course whose instructor no longer exists.	includes/admin/views/courses.php:392
learnomy_warn_on_empty_publish	filter	true, $course_id	Filter whether to warn about publishing an empty course.	includes/admin/class-empty-curriculum-notice.php:69
learnomy_webhook_row_actions	action	$hook	Fires after the row actions of a webhook in the admin webhooks list, so extensions can echo.	includes/admin/views/webhooks.php:456
learnomy_webhook_row_actions_list	filter	$row_actions, $hook	Filter the row actions for a webhook list row.	includes/admin/views/webhooks.php:446

Api

Hook	Type	Arguments	What it is for	Fired in
learnomy_account_fields_save	action	$user_id, $request	Persist custom account fields captured at REGISTRATION. Same action the.	includes/api/class-auth-controller.php:992 (3)
learnomy_account_fields_validate	filter	true, $request, 'instructor' === $role ? 'registration_instructor' : 'registration_stud...	Reject a registration or account save before anything is written.	includes/api/class-auth-controller.php:898 (3)
learnomy_admin_reset_course_progress	action	$user_id, $course_id	Fires after an admin resets a student’s progress, quiz attempts and enrollment summary for a.	includes/api/class-admin-controller.php:1580
learnomy_api_controllers	filter	$classes	The REST controllers Learnomy registers, so an extension can add, replace or remove one.	includes/api/class-api.php:357
learnomy_app_config_branding	filter	$defaults	Filter the app branding block. The Pro white-label extension maps.	includes/api/class-app-config-controller.php:235
learnomy_app_config_features	filter	$features	Filter the app feature flags. Learnomy Pro injects one flag per.	includes/api/class-app-config-controller.php:302
learnomy_app_config_legal	filter	$legal	Filter the app legal block (per-site URLs, owner-configurable).	includes/api/class-app-config-controller.php:330
learnomy_app_enabled	filter	false	Filter whether the mobile app may connect to this site.	includes/api/class-app-config-controller.php:178
learnomy_app_min_version	filter	'1.0.0'	Filter the minimum app version this site supports. The app.	includes/api/class-app-config-controller.php:84
learnomy_before_student_self_delete	action	$user_id, $user->user_email	Fires immediately before the WordPress user row is removed during.	includes/api/class-auth-controller.php:1435
learnomy_broadcast_max_audience	filter	10000	Hard ceiling for a broadcast audience. Requests that resolve more.	includes/api/class-broadcasts-controller.php:529 (2)
learnomy_broadcast_send_email	filter	true, $audience, $actor_id	Filter whether this broadcast may also go out by email.	includes/api/class-broadcasts-controller.php:449
learnomy_bulk_enroll_max	filter	500	The maximum number of email addresses one bulk enrollment request processes. Extra addresses.	includes/api/class-admin-controller.php:1808
learnomy_cancel_reasons	filter	$default	The reasons a member can pick when cancelling a subscription.	includes/api/class-membership-controller.php:852
learnomy_cancel_retention_offers	filter	array(), $sub, $user_id	The retention offers shown to a member before they cancel a subscription.	includes/api/class-membership-controller.php:805
learnomy_cancellable_subscription_statuses	filter	array( 'active', 'past_due', 'trialing', 'paused' ), $sub	The subscription statuses a member may cancel from.	includes/api/class-membership-controller.php:722
learnomy_checkout_extra	filter	$lrn_extra, $lrn_purchase_type, $request	Metadata to carry with an extension purchase.	includes/api/class-checkout-controller.php:967
learnomy_checkout_thank_you_url	filter	$url, $gateway_id, $context	Filters the buyer’s post-purchase return URL.	includes/api/class-checkout-controller.php:1411
learnomy_course_rest_args	filter	$args	The argument schema of the course create and update REST routes.	includes/api/class-courses-controller.php:2532
learnomy_course_rest_fields	filter	$data, $request	The fields of a course in a REST response.	includes/api/class-courses-controller.php:2191
learnomy_course_reviews_per_page	filter	10, $course_id	The number of reviews one page of a course’s review list returns. Clamped to 1-50.	includes/api/class-reviews-controller.php:298 (2)
learnomy_course_saved	action	$course_id, $request	Fires after a course is created or updated via REST, carrying the.	includes/api/class-courses-controller.php:703 (2)
learnomy_course_settings_rest	filter	$out, $raw	The course settings accepted from a REST request. Lets extensions accept extra keys they.	includes/api/class-courses-controller.php:2350
learnomy_course_students_rest_items	filter	$items, $course_id, get_current_user_id()	Filter the REST course-students rows before the response. Lets an.	includes/api/class-enrollments-controller.php:724
learnomy_email_log_resent	action	$id, $user_id, $sent, $reason	Fires after an admin manually resends a logged notification email.	includes/api/class-email-log-controller.php:161
learnomy_external_enrollment_requested	action	$user_id, $course_id, $request	Fires after an incoming webhook has enrolled a user, for add-ons such as xAPI.	includes/api/class-webhooks-controller.php:649
learnomy_guest_account_created	action	$new_guest_account_id, \Learnomy\Models\Transaction::find( (int) $txn_id )	Fires after a guest checkout created a new user account and its transaction was recorded.	includes/api/class-checkout-controller.php:1268 (2)
learnomy_incoming_webhook_payload	filter	[ 'user_email' => sanitize_email( (string) $request->get_param( 'user_email' ) ), 'cour...	The parameters of an incoming enrollment webhook. Lets an adapter normalise a third-party.	includes/api/class-webhooks-controller.php:538
learnomy_lesson_attachments_reordered	action	$lesson_id, $ids	Fires after a lesson’s attachments are reordered.	includes/api/class-lesson-attachments-controller.php:243
learnomy_lesson_comment_posted	action	$comment_id, $lesson_id, $user_id	Fires after a new lesson comment is posted and is live. Comments held for moderation fire.	includes/api/class-comments-controller.php:462 (2)
learnomy_lesson_comment_replied	action	$comment_id, $parent_id, $lesson_id, $user_id	Fires after a reply to a lesson comment is posted and is live.	includes/api/class-comments-controller.php:565 (2)
learnomy_lesson_created	action	$lesson_id, $course_id, $data	Fires after a lesson is created through the REST API.	includes/api/class-lessons-controller.php:981 (2)
learnomy_lesson_editor_panels	filter	[], $lesson_id, $lesson	Per-lesson panels for a client-rendered lesson editor.	includes/api/class-lessons-controller.php:1604
learnomy_lesson_numeric_ref_types	filter	array( 'mediashield' )	The lesson content types whose video field stores a numeric reference ID rather than a URL.	includes/api/class-lessons-controller.php:1929
learnomy_lesson_resources	action	$lesson_id, $items	Fire once per list fetch so later surfaces (student Resources section,.	includes/api/class-lesson-attachments-controller.php:143
learnomy_lesson_saved	action	$lesson_id, $request	Documented in create_lesson_in_section().	includes/api/class-lessons-controller.php:983 (3)
learnomy_lesson_updated	action	(int) $lesson->id, $data	Fires after a lesson is updated through the REST API.	includes/api/class-lessons-controller.php:1100
learnomy_lesson_video_progress	action	$user_id, (int) $lesson->id, $watch_pct		includes/api/class-lessons-controller.php:1667
learnomy_lessons_reassigned	action	$updated_ids	Fires after lessons are moved between sections.	includes/api/class-sections-controller.php:461
learnomy_lessons_reordered	action	$section_id, $order	Fires after the lessons of a section are reordered.	includes/api/class-lessons-controller.php:1198
learnomy_login_credential_error_codes	filter	array( 'empty_username', 'empty_password', 'invalid_username', 'invalid_email', 'incorr...	Error codes meaning “these credentials are wrong” and nothing more.	includes/api/class-auth-controller.php:531
learnomy_membership_plan_archived	action	$plan_id	Fires after a membership plan that still has dependants is set to inactive instead of being.	includes/api/class-membership-controller.php:1118
learnomy_membership_plan_deleted	action	$plan_id	Fires after a membership plan with no dependants is hard-deleted along with its course links.	includes/api/class-membership-controller.php:1134
learnomy_membership_plan_has_dependants	filter	$has_subs, $plan_id	Does anything else still depend on this plan?.	includes/api/class-membership-controller.php:1108
learnomy_membership_plan_saved	action	$plan_id, true	Fires after a membership plan is created.	includes/api/class-membership-controller.php:1039 (2)
learnomy_membership_resume_paused	filter	false, $subscription_id, $sub	Resumes a paused subscription. Free cannot, so Pro handles it and returns the result.	includes/api/class-membership-controller.php:980
learnomy_module_route_map	filter	[ // questionandquiz bare, so every hyphenated child is covered // by the rule ra...	Route pattern => module slug, for the modules a site owner can switch.	includes/api/class-api.php:171
learnomy_module_toggled	action	$slug, $enabled	Fires after an admin enables or disables a Learnomy module.	includes/api/class-admin-controller.php:2232
learnomy_my_courses_per_page	filter	40	The number of courses one page of the My Courses list returns. Clamped to 1-100 afterwards.	includes/api/class-enrollments-controller.php:236 (2)
learnomy_pro_can_broadcast_to_space	filter	user_can( $user_id, 'manage_options' ), $space_id, $user_id	Whether a user may send a broadcast to a space audience. Free has no Spaces model, so Pro.	includes/api/class-broadcasts-controller.php:340
learnomy_pro_quiz_filter_marks	filter	$marks_by_qid, $questions, (int) $quiz->id	Filter what each question on THIS paper is worth: question id => marks.	includes/api/class-quizzes-controller.php:1322
learnomy_pro_quiz_filter_questions	filter	$questions, (int) $quiz->id, []	Filter the question objects a quiz attempt presents. Receives the.	includes/api/class-quizzes-controller.php:1288
learnomy_pro_space_member_user_ids	filter	array(), $space_id	The user IDs of a space’s members, resolved by Pro when a broadcast targets a space.	includes/api/class-broadcasts-controller.php:587
learnomy_pro_space_title	filter	__( 'Learning Space', 'learnomy' ), $space_id	The display title of a space audience, shown for a broadcast sent to a space.	includes/api/class-broadcasts-controller.php:594
learnomy_quiz_attempts_granted	action	$user_id, $quiz_id, $granted, $attempts	Fires after an admin changes a student’s extra-attempt balance on a quiz.	includes/api/class-admin-controller.php:1643
learnomy_quiz_created	action	$quiz_id, $data	Fires after a quiz is created through the REST API.	includes/api/class-quizzes-controller.php:967
learnomy_quiz_player_context	filter	$player_context, (int) $quiz->id, (int) $attempt->id	Filter the quiz player context payload sent to the client on quiz start.	includes/api/class-quizzes-controller.php:1649
learnomy_quiz_saved	action	$quiz_id, $request	Fires after a quiz is created or updated via REST, carrying the request,.	includes/api/class-quizzes-controller.php:976 (2)
learnomy_quiz_slots_reordered	action	$quiz_id, $clean_order	Fires after the question slots of a quiz are reordered.	includes/api/class-quizzes-controller.php:721
learnomy_quiz_submit_grace_seconds	filter	60, $attempt	The grace period, in seconds, after a timed attempt’s deadline before a submission is.	includes/api/class-quizzes-controller.php:1839
learnomy_quiz_timer_resume_policy	filter	'wall_clock', $quiz, $attempt	How a timed quiz attempt’s clock behaves when the student resumes it.	includes/api/class-quizzes-controller.php:1546
learnomy_quiz_updated	action	(int) $quiz->id, $data	Fires after a quiz is updated through the REST API.	includes/api/class-quizzes-controller.php:1031
learnomy_registration_challenge_verify	filter	true, $request	This filter is documented in includes/api/class-auth-controller.php.	includes/api/class-checkout-controller.php:245 (2)
learnomy_report_resolved	action	$report_id, $status, get_current_user_id()	Fires after a moderator resolves a report.	includes/api/class-reports-controller.php:246
learnomy_report_submitted	action	$report_id, $object_type, $object_id, $user_id, $reason	Fires after a member files a moderation report.	includes/api/class-reports-controller.php:206
learnomy_rest_lesson_payload	filter	$filtered, $lesson, $request	Filter the single-lesson REST payload.	includes/api/class-lessons-controller.php:926
learnomy_section_created	action	$section_id, $course_id	Fires after a course section is created through the REST API.	includes/api/class-sections-controller.php:317
learnomy_section_items_reordered	action	$section_id, $items	Fires after the mixed lessons and quizzes inside a section are reordered.	includes/api/class-sections-controller.php:492
learnomy_section_updated	action	(int) $section->id, $data	Fires after a course section is updated through the REST API.	includes/api/class-sections-controller.php:379
learnomy_sections_reordered	action	$course_id, $order	Fires after a course’s sections are reordered.	includes/api/class-sections-controller.php:531
learnomy_student_account_deleted	action	$user->user_email	Fires after the student user row is successfully removed.	includes/api/class-auth-controller.php:1459
learnomy_subscription_extended	action	$sub_id, (int) $sub->user_id, (int) $sub->plan_id	Fires after an admin extends a subscription’s period.	includes/api/class-membership-controller.php:1380
learnomy_user_blocked	action	$me, $target	Fires after one member blocks another.	includes/api/class-blocks-controller.php:141
learnomy_user_registered	action	$user_id, $role	Fires after a new user registers through the Learnomy frontend.	includes/api/class-auth-controller.php:978
learnomy_user_unblocked	action	$me, $target	Fires after one member unblocks another.	includes/api/class-blocks-controller.php:161
learnomy_validate_plan_space_id	filter	is_numeric( $v ) && (int) $v >= 0, $v	Whether a space ID is acceptable on a membership plan. Pro tightens this to require that the.	includes/api/class-membership-controller.php:540
learnomy_withdrawal_approved	action	(int) $withdrawal->instructor_id, $withdrawal	Fires after an admin approves an instructor withdrawal and it is marked processed.	includes/api/class-admin-controller.php:958
learnomy_withdrawal_rejected	action	$withdrawal_id, (int) $withdrawal->instructor_id, $reason	Fires after an admin rejects a withdrawal and its commissions are returned to pending.	includes/api/class-admin-controller.php:999

Auth

Hook	Type	Arguments	What it is for	Fired in
learnomy_app_connect_bridge	filter	$info	Filter the resolved app-connect bridge for this site.	includes/auth/class-app-connect.php:155
learnomy_app_connect_schemes	filter	array( App_Authorize_Access::app_scheme() )	Filter the custom URL schemes the Learnomy app-connect flow may.	includes/auth/class-app-connect.php:113
learnomy_app_credential_issued	action	$user->ID, $app_id, $app_name	Fires after a member exchanges their password for an app credential.	includes/auth/class-app-credentials.php:193
learnomy_app_password_login_enabled	filter	$on	Filter whether members may exchange a WordPress password for an.	includes/auth/class-app-credentials.php:89
learnomy_app_scheme	filter	self::DEFAULT_APP_SCHEME	Filter the mobile app’s deep-link scheme.	includes/auth/class-app-authorize-access.php:109
learnomy_email_verified_redirect	filter	\Learnomy\route_url( 'student-dashboard' ), $user_id	Where a user is sent after their email address is verified and they are signed in.	includes/auth/class-email-verification.php:241
learnomy_generic_login_errors	filter	true	Whether to answer every failed sign-in identically.	includes/auth/class-login-flow.php:252
learnomy_login_redirect	filter	$destination, $user, $redirect_to	Filter where a member lands after signing in.	includes/auth/class-login-flow.php:158

Blocks

Hook	Type	Arguments	What it is for	Fired in
learnomy_my_progress_max	filter	20	The maximum number of in-progress courses the My Progress block lists. 0 lists them all.	blocks/my-progress/render.php:66

Cli

Hook	Type	Arguments	What it is for	Fired in
learnomy_cli_commands	action		Fires after built-in CLI commands are registered.	includes/cli/class-cli.php:93
learnomy_repair_data_integrity_tasks	filter	array(), $dry_run	Filters the extension-contributed data-integrity tasks.	includes/cli/class-repair.php:458

Content

Hook	Type	Arguments	What it is for	Fired in
learnomy_content_allowed_html	filter	$allowed, $context	Filter the content allow-list (save gate + render floor).	includes/content/class-content-html.php:515
learnomy_content_migratable_fields	filter	$fields	Filter the content fields a migration converts.	includes/content/class-content-migrator.php:132
learnomy_content_premigration_backup_written	action	$file, $rows	Fires after the pre-migration content backup is written, before content is converted to.	includes/content/class-content-migrator.php:294
learnomy_content_snapshot_fields	filter	$fields	Filter the content fields that get snapshotted before a migration.	includes/content/class-content-migrator.php:69
learnomy_embed_blocked_hosts	filter	array(), $url	Filter the embed host deny-list (lowercase hosts).	includes/content/class-embed.php:354
learnomy_embed_fediverse_enabled	filter	$enabled, $url	Filter whether guarded Fediverse/oEmbed discovery runs.	includes/content/class-embed.php:332
learnomy_embed_html	filter	$html, $url, $opts	Filter the final embed HTML (after wrap + caption).	includes/content/class-embed.php:81
learnomy_embed_oembed_args	filter	array( 'maxwidth' => 1280, 'discover' => false, ), $url	Filter the args passed to wp_oembed_get for the FIRST pass (core providers).	includes/content/class-embed.php:188
learnomy_embed_platform_adapters	filter	array( array( __CLASS__, 'peertube_adapter' ) )	Filter the federated-platform embed adapters. Each is.	includes/content/class-embed.php:271
learnomy_store_content_as_html	filter	true	Whether new lesson content is stored as HTML rather than Editor.js JSON. False opts the site.	includes/content/class-content-html.php:571

Core

Hook	Type	Arguments	What it is for	Fired in
learnomy_account_nav_items	filter	$items, $current	Filter the account navigation items. Pro adds its account surfaces here.	includes/functions.php:3807
learnomy_account_nav_section_map	filter	$section_by_key	Filter the account-nav item -> section map, so a developer can move an.	includes/functions.php:3850
learnomy_account_routes	filter	array( 'student-dashboard', 'account-courses', 'account-quiz-results', 'account-billing...	The routes that make up the My Account area and share its vertical nav.	includes/functions.php:3608
learnomy_app_user_agent_token	filter	'LearnomyApp'	Token the native app appends to its WebView User-Agent. White-label apps.	includes/functions.php:2149
learnomy_asset_filemtime	filter	$on	Whether Learnomy asset URLs use the file’s modified time as their version, so a changed file.	includes/functions.php:5078
learnomy_become_instructor_slug	filter	'become-instructor'	The URL slug of the instructor application page.	includes/functions.php:537
learnomy_billing_slug	filter	account_slug() . '/billing'	The URL path of the account billing page.	includes/functions.php:507 (2)
learnomy_block_allowed_html	filter	$allowed, $name	Filter the allowed-HTML set used to sanitise Learnomy block output.	includes/class-blocks.php:437
learnomy_block_category_label	filter	__( 'Learnomy', 'learnomy' )	Label for the Learnomy block-inserter category.	includes/class-blocks.php:526
learnomy_block_output	filter	$html, $attributes, $name	The rendered markup of a Learnomy block, filtered before it is sanitised and echoed.	includes/class-blocks.php:476
learnomy_branding_url	filter	'https://learnomy.com'	Destination for the attribution link. Return ‘’ to render plain text.	includes/functions.php:4820
learnomy_breadcrumb_root	filter	$item	Filter the shared breadcrumb root. 10k sites, more than one mind: a.	includes/functions.php:2052
learnomy_cancelled_slug	filter	enroll_slug() . '/cancelled'	The URL path of the checkout cancelled page.	includes/functions.php:525
learnomy_certificate_expired	action	(int) $row->id, (int) $row->user_id, (int) $row->course_id	Fires after the daily sweep marks a certificate as expired.	includes/class-cron.php:801
learnomy_checkout_default_country	filter	'US'	The billing country the checkout Address Element starts with.	includes/class-template-loader.php:3210
learnomy_content_can_access	filter	$user_id > 0, $user_id	Filter whether a viewer may read course content while the academy is private.	includes/functions.php:737
learnomy_content_route_names	filter	array( 'catalog', 'category', 'course', 'lesson', 'quiz', 'standalone-quiz' )	The course content routes gated by the require-login setting.	includes/functions.php:817
learnomy_countries	filter	$wc	This filter is documented below.	includes/functions.php:5184 (2)
learnomy_course_approved	action	$course_id	Fires after a course is approved and published through the approve-course ability.	includes/class-abilities.php:2631
learnomy_course_rejected	action	$course_id, $reason	Fires after a course is rejected through the reject-course ability and set back to draft.	includes/class-abilities.php:2656
learnomy_course_taxonomies	filter	$default	The tag taxonomies offered for courses.	includes/functions.php:4863
learnomy_cron_jobs	filter	$events	The recurring cron events Learnomy schedules, so extensions can register theirs.	includes/class-cron.php:181
learnomy_currency_names	filter	array( 'AED' => __( 'United Arab Emirates dirham', 'learnomy' ), 'AFN' => __( 'Afghan a...	Filter the human names shown in a currency picker.	includes/functions.php:2805
learnomy_currency_options	filter	$options, $args	Filter the options shown in a currency picker.	includes/functions.php:2787
learnomy_currency_symbol_position	filter	$position, $currency, $locale	Filter the currency symbol position.	includes/functions.php:3275
learnomy_currency_symbols	filter	array( 'AED' => 'د.إ', 'AFN' => '؋', 'ALL' => 'L', 'AMD' => 'AMD', 'ANG' => 'ƒ', 'A...	Map of ISO 4217 currency code to display symbol.	includes/functions.php:3001
learnomy_distraction_free_route	filter	$distraction_free, $route	Whether a route renders without the theme header and footer.	includes/class-template-loader.php:500
learnomy_docs_url	filter	'https://learnomy.app/docs/'	Filter the documentation base URL.	includes/functions.php:5137
learnomy_edd_item_id	filter	1662698	The EDD product id used to register the plugin for license updates.	learnomy.php:104
learnomy_email_log_retention_days	filter	$retention_days	Filter the email-log retention window in days.	includes/class-cron.php:770
learnomy_enable_pwa	filter	false	Whether the Learnomy PWA (service worker, offline banner and manifest) is enabled. This call.	includes/functions.php:885 (3)
learnomy_enrollment_expired	action	(int) $row->id, (int) $row->user_id, (int) $row->course_id	Fires after the expiry sweep marks an enrollment’s access as expired.	includes/class-cron.php:291
learnomy_entity_labels	filter	$defaults	Filters the set of renamable nouns.	includes/functions.php:1506
learnomy_erase_app_data	action	$user_id	Fires during a member data-erase so Pro extensions can wipe their own.	includes/class-privacy.php:622
learnomy_erase_authored_course	action	$course_id, $user_id	Fires before an erased author’s course is removed.	includes/class-privacy.php:446
learnomy_extension_enabled	filter	false, $slug	Filter whether a Pro extension is enabled on this site.	includes/functions.php:596
learnomy_for_sale_models	filter	array( Models\MembershipPlan::class )	The model classes whose rows are for sale. Each has.	includes/class-learnomy.php:1414
learnomy_hide_admin_bar_for_students	filter	true	Filter whether the WP admin bar is hidden for pure students.	includes/class-learnomy.php:131
learnomy_init	action	$this	Fires after Learnomy has fully initialized all dependencies.	includes/class-learnomy.php:717
learnomy_instructor_application_approved	action	$application_id, (int) ( $application->user_id ?? 0 )	Fires when an instructor application is approved.	includes/class-abilities.php:2561 (2)
learnomy_instructor_application_rejected	action	$application_id, (int) ( $application->user_id ?? 0 ), $reason	Fires when an instructor application is rejected. Same action and.	includes/class-abilities.php:2598 (2)
learnomy_instructor_application_submitted	action	(int) $application_id, $user_id	Fires when a student submits an instructor application. Notifier.	includes/class-router.php:893 (3)
learnomy_instructor_approved	action	$application_id	Legacy alias, kept firing.	includes/class-abilities.php:2573
learnomy_instructor_course_edit_url	filter	$backend, $course_id	The frontend URL of the course editor shown in the instructor’s in-content bar. Returning.	includes/class-admin-bar.php:113 (3)
learnomy_instructor_lesson_edit_url	filter	$backend, $course_id, $lesson_id	The frontend URL of the lesson editor shown in the instructor’s in-content bar. Returning.	includes/class-admin-bar.php:134
learnomy_instructor_nav_items	filter	$items, $current		includes/functions.php:3950
learnomy_instructor_profile_url	filter	$url, $instructor	Filter the instructor profile URL used across course and lesson surfaces.	includes/functions.php:1987
learnomy_instructor_quiz_edit_url	filter	$backend, $quiz_id, $course_id	The frontend URL of the quiz editor shown in the instructor’s in-content bar. Returning the.	includes/class-admin-bar.php:157
learnomy_instructor_registration_enabled	filter	! solo_mode()	Whether visitors may apply to become instructors.	includes/functions.php:610
learnomy_instructor_rejected	action	$application_id, $reason	Legacy alias, kept firing.	includes/class-abilities.php:2608
learnomy_instructor_routes	filter	// 'instructor-reports' is NOT here, and its absence is the point. That // route is reg...	The instructor routes that use the shared teaching layout and its stylesheets.	includes/functions.php:3641
learnomy_instructor_shell_routes	filter	array( 'instructor-dashboard', 'instructor-reports', 'instructor-courses', 'instructor-...	The instructor routes that render through the shared teaching shell and so load the.	includes/class-template-loader.php:1431
learnomy_is_editor_preview	filter	defined( 'REST_REQUEST' ) && REST_REQUEST && current_user_can( 'edit_posts' )	Filters whether a block is being drawn as an editor preview.	includes/functions.php:3475
learnomy_layouts	filter	$surfaces	Filters the layout registry. Pro / third-party code adds variants to a.	includes/functions.php:1218
learnomy_lesson_html_allowed_html	filter	$allowed, $raw	Filter the allowed-HTML set used to sanitise raw lesson bodies (legacy.	includes/functions.php:4372
learnomy_lesson_require_watch_percent	filter	0, $lesson, $course	The video watch percentage a lesson requires before it can be marked complete, as enforced.	includes/class-template-loader.php:3460 (4)
learnomy_lesson_taxonomies	filter	$default	The tag taxonomies offered for lessons.	includes/functions.php:4898
learnomy_live_session_duration	filter	60, $lesson	Filter the default length of a live session, in minutes.	includes/functions.php:2401
learnomy_member_payment_provider_label	filter	$label, $slug	Filter the buyer-facing name of a payment provider.	includes/functions.php:3417
learnomy_membership_faq_items	filter	$faq	Filter the membership FAQ rows. Each row: { q, a }.	includes/functions.php:4060
learnomy_membership_on_offer	filter	module_enabled( 'membership' )	Filter whether membership sign-up CTAs may render.	includes/functions.php:2195
learnomy_multi_instructor_enabled	filter	$on	Whether co-instructors and revenue sharing are offered.	includes/functions.php:686
learnomy_offline_slug	filter	'learnomy-offline'	The URL slug of the offline page served by the PWA shell.	includes/functions.php:858
learnomy_payout_method_aliases	filter	array( 'bank' => 'bank_transfer', 'banktransfer' => 'bank_transfer', 'bank-transfer' =>...	The alternate spellings of payout methods that are normalised to a canonical method.	includes/functions.php:1708
learnomy_payout_methods	filter	$methods	Filter the payout rails.	includes/functions.php:1690
learnomy_privacy_authored_batch	filter	self::AUTHORED_BATCH	The number of rows processed per batch when erasing a user’s authored content.	includes/class-privacy.php:409
learnomy_privacy_authored_content_erasure	filter	'delete'	What happens to content the data subject authored.	includes/class-privacy.php:571
learnomy_privacy_authored_time_budget	filter	self::AUTHORED_TIME_BUDGET	Seconds one authored-content pass may run before stopping and.	includes/class-privacy.php:419
learnomy_privacy_certificate_erasure	filter	'delete'	How a certificate is erased for a GDPR request.	includes/class-privacy.php:2006
learnomy_privacy_content_reassign_to	filter	$default	User ID that authored content is reassigned to during a GDPR erase.	includes/class-privacy.php:380
learnomy_pro_active	filter	defined( 'LEARNOMY_PRO_VERSION' )	Whether Learnomy Pro counts as active. A test can force this to fake Pro.	includes/functions.php:1835 (2)
learnomy_protected_routes	filter	$protected_routes		includes/class-template-loader.php:255
learnomy_provider_cancel_sweep_limit	filter	25	The number of provider-side subscription cancellations reconciled in one hourly run.	includes/class-cron.php:833
learnomy_purchase_descriptor	filter	$descriptor, $type, $item_id	Describe a purchase type for display on a gateway’s order record.	includes/functions.php:5519
learnomy_purge_page_cache	action	$url	Fires when a Learnomy URL’s cached copy is stale. Hook a CDN or any page.	includes/functions.php:5615
learnomy_pwa_app_name	filter	get_bloginfo( 'name' )	The app name in the PWA web manifest.	includes/class-router.php:944
learnomy_pwa_app_short_name	filter	'Learnomy'	The app name in the PWA web manifest.	includes/class-router.php:950
learnomy_pwa_icon	filter	$icon	The app name in the PWA web manifest.	includes/class-router.php:971
learnomy_pwa_manifest	filter	$manifest	Filter the whole PWA manifest before it is served.	includes/class-router.php:984
learnomy_pwa_theme_color	filter	'#2383e2'	The app name in the PWA web manifest.	includes/class-router.php:961
learnomy_query_vars	filter	$vars	The public query variables Learnomy registers with WordPress.	includes/class-router.php:366
learnomy_question_taxonomies	filter	$default	The tag taxonomies offered for quiz questions.	includes/functions.php:4929
learnomy_question_types	filter	$types	Filters the registered question types.	includes/class-question-types.php:67
learnomy_quiz_display_templates	filter	$templates	Filter the quiz display templates.	includes/functions.php:1888
learnomy_quiz_start_style	filter	$style	Filter the quiz start-screen layout.	includes/functions.php:1934
learnomy_quiz_taxonomies	filter	$default	The tag taxonomies offered for quizzes.	includes/functions.php:4956
learnomy_reengagement_enabled	filter	true	Whether the inactivity re-engagement email runs at all.	includes/class-cron.php:391
learnomy_reengagement_max_per_run	filter	500	The maximum number of re-engagement emails queued in one run.	includes/class-cron.php:408
learnomy_register_abilities	action		Fires inside wp_abilities_api_init after Learnomy’s own abilities are registered, so.	includes/class-abilities.php:135
learnomy_register_instructor_slug	filter	'register/instructor'	The URL slug of the instructor registration page.	includes/functions.php:846
learnomy_register_student_slug	filter	'register/student'	The URL slug of the student registration page.	includes/functions.php:834
learnomy_registered_tag_types	filter	$types	Extend the allow-list for vocabularies not surfaced by the three core.	includes/functions.php:4982
learnomy_reminder_cadences	filter	array( '7d', '3d', '1d' )	The cadences at which expiry reminders are sent before an enrollment’s access ends.	includes/class-cron.php:463 (2)
learnomy_require_login_for_content	filter	$on	Whether course content routes redirect logged-out visitors to the login page.	includes/functions.php:708
learnomy_reserved_slugs	filter	array( // WP pagination segment. 'page', // /instructor/ children (Pro frontend builder...	The URL segments reserved by Learnomy, which a course or other slug may not use.	includes/functions.php:410
learnomy_route_access_gates	filter	array( 'instructor-courses' => 'partials/instructor-access-gate.php', 'instructor-stude...	Filter the routes that render an access gate instead of a 404.	includes/class-template-loader.php:641
learnomy_route_capabilities	filter	self::$capability_routes	Capability gate. Being logged in is not the same as being allowed:.	includes/class-template-loader.php:298
learnomy_route_enabled	filter	true, $route	Per-route enable gate. A route whose feature/module is turned off.	includes/class-template-loader.php:343
learnomy_route_http_status	filter	(int) ( $view_data['http_status'] ?? 200 ), $route, $data, $view_data	The HTTP status a route renders with, such as 403 or 410. Decided before headers are sent.	includes/class-template-loader.php:558
learnomy_route_no_cache_for_user	filter	true, $route	Whether a logged-in user’s Learnomy page is sent with private, no-cache headers so a page.	includes/class-template-loader.php:364
learnomy_route_not_found	filter	! empty( $view_data['not_found'] ), $route, $data, $view_data	Whether the request is a 404. Lets a route without its own view-data resolver declare that.	includes/class-template-loader.php:535
learnomy_route_slug	filter	$value, $option_key	Uniform slug filter - THE single seam the route registry promised, so a.	includes/functions.php:374
learnomy_route_title	filter	'', $route, $data	Filter the