• Beehive - Google Analytics
  • Branda
  • Defender
  • Forminator
  • Hummingbird
  • Hustle
  • Shipper
  • SmartCrawl SEO
  • Smush
  • Snapshot
  • WPMU DEV Dashboard

Shipper Hooks Documentation

Total hooks: 89
Undocumented hooks: 28

1. shipper_enable_data_recording

Type: filter

No description

Arguments: true

2. shipper_enable_data_recording

Type: filter

No description

Arguments: false

3. shipper_enable_data_recording

Type: filter

No description

Arguments: true

4. shipper_migration_before_task

Type: action

Fires just before the current task processing

Arguments: $task

Arguments:

  • $task - object
    Task instance.

5. shipper_migration_after_task

Type: action

Fires just after the current task processing

Arguments: $task, $status

Arguments:

  • $task - object
    Task instance.

  • $status - bool
    Done or not

6. shipper_path_include_table

Type: filter

Whether to actually include this table in migration processing

Arguments: true, $table

Arguments:

  • $do_process_item - bool
    Include item.

  • $table - string
    Table name.

7. shipper_export_tables_row_limit

Type: filter

No description

Arguments: 250

8. shipper_export_max_upload_statements

Type: filter

Number of file statements to upload in one step

Arguments: 10

Arguments:

  • $limit - int
    Maximum number of files.

9. shipper_api_service_url

Type: filter

DEV API service URL

Arguments: $service_url

Arguments:

  • $service_url - string
    Shipper DEV API service URL.

10. shipper_api_request_args

Type: filter

Pre-process the service call args

Arguments: $args, $endpoint

Arguments:

  • $args - array
    Remote request arguments.

  • $endpoint - string
    Requested endpoint.

11. shipper_import_mock_files

Type: filter

Whether we're in import mocking mode, defaults to false.

<p>In files import mocking mode, none of the files will be actually copied over to their final destination.</p>

Arguments: false

Arguments:

  • $is_mock_import - bool
    Whether we're in mock import mode.

12. shipper_import_mock_files

Type: filter

Whether we're in import mocking mode, defaults to false.

<p>In files import mocking mode, none of the files will be actually copied over to their final destination.</p>

Arguments: false

Arguments:

  • $is_mock_import - bool
    Whether we're in mock import mode.

13. shipper_migration_before_task

Type: action

Fires just before the current task processing

Arguments: $task

Arguments:

  • $task - object
    Task instance.

14. shipper_migration_after_task

Type: action

Fires just after the current task processing

Arguments: $task, $status

Arguments:

  • $task - object
    Task instance.

  • $status - bool
    Done or not

15. shipper_import_mock_files

Type: filter

Whether we're in import mocking mode, defaults to false.

<p>In files import mocking mode, none of the files will be actually copied over to their final destination.</p>

Arguments: false

Arguments:

  • $is_mock_import - bool
    Whether we're in mock import mode.

16. shipper_task_import_tables_list

Type: filter

Source tables processing list

<p>Used in tests suite.</p>

Arguments: $tables

Arguments:

  • $tables - array
    List of extracted table names (from SQL files).

17. shipper_import_tables_row_limit

Type: filter

No description

Arguments: 25

18. shipper_import_mock_tables

Type: filter

Whether we're in import mocking mode, defaults to false.

<p>In tables import mocking mode, intermediate tables will be created. However, they won't be ported over to the existing tables. As a side-effect of this, the database size <em>will</em> double.</p>

Arguments: false

Arguments:

  • $is_mock_import - bool
    Whether we're in mock import mode.

19. shipper_import_skip_scrub

Type: filter

No description

Arguments: false

20. shipper_import_skip_scrub

Type: filter

No description

Arguments: false

21. shipper_import_is_config_deployment_prevented

Type: filter

No description

Arguments: \Shipper_Model_Env::is_auth_requiring_env()

22. shipper_import_mock_files

Type: filter

Whether we're in import mocking mode, defaults to false.

<p>In files import mocking mode, none of the files will be actually copied over to their final destination.</p>

Arguments: false

Arguments:

  • $is_mock_import - bool
    Whether we're in mock import mode.

23. shipper_import_is_config_file_deployable

Type: filter

Whether the file is deployable

Arguments: true, basename($filepath), $filepath

Arguments:

  • $deployable - bool
    Whether the file is deployable.

  • $basename - string
    Basename of the file.

  • $path - string
    Full path to the file.

24. shipper_checks_hub_dashboard_present

Type: filter

Dashboard present check filter

Arguments: $present

Arguments:

  • $result -
    Whether the dash is present.

25. shipper_checks_hub_dashboard_active

Type: filter

Dashboard active check filter

Arguments: $result

Arguments:

  • $result -
    Whether the dash is active.

26. shipper_checks_hub_dashboard_apikey

Type: filter

Dashboard API key presence check filter

Arguments: $model->get('api_key')

Arguments:

  • $result -
    Whether the dash API key is present.

27. shipper_runner_tick_validity_interval

Type: filter

No description

Arguments: 600, $this->_process

28. shipper_kickstarted

Type: action

Fires on kickstart attempt

Arguments: none

29. shipper_runner_pre_request_tick

Type: action

Fires just before runner tick processing, after locking

Arguments: $this

Arguments:

  • $runner - object
    Runner instance.

30. shipper_flag_cleared

Type: action

Fires on stale lock removal

Arguments: $lock

Arguments:

  • $lock - string
    Process lock identifier.

31. secure_auth_cookie

Type: filter

No description

Arguments: $secure, $user_id

32. shipper_runner_ping_timeout

Type: filter

Gets the runner ping timeout

<p>This is a (fractional) number of seconds we're allowing to our self-ping POST request to run.</p> <p>Default is 30s for blocking requests, and 0.5s for non-blocking.</p>

Arguments: $timeout

Arguments:

  • $timeout - float
    Ping timeout, in seconds.

33. shipper_runner_ping_is_blocking

Type: filter

Whether the runner self-ping request is a blocking one

<p>Defaults to false.</p>

Arguments: false

Arguments:

  • $is_blocking - bool
    Whether the request will be a blocking one.

34. shipper_heartbeat_cron_restart

Type: action

Triggers just before cron respawning.

<p>Used in tests</p>

Arguments: none

35. shipper_enable_data_recording

Type: filter

No description

Arguments: true

36. shipper_migration_api_status_update

Type: filter

Whether to update the DEV API on migration progress status

Arguments: true, $task

Arguments:

  • $do_update - bool
    Whether to send status update.

  • $task - object
    Overall task (which can be queried for has_completed_task).

37. shipper_dev_ping

Type: action

Fires on remote migration kickstart

Arguments: none

38. shipper_migration_log_clear

Type: filter

Whether to clear the log on migration prep

Arguments: true, $migration

Arguments:

  • $clear_log - bool
    Whether to clear the log or not.

  • $migration - object
    Shipper_Model_Stored_Migration instance.

39. shipper_migration_start

Type: action

Fires on migration start

Arguments: $migration

Arguments:

  • $migration - object
    Shipper_Model_Stored_Migration instance.

40. shipper_migration_complete

Type: action

Fires on migration complete.

Arguments: $migration

Arguments:

  • - object
    Shipper_Model_Stored_Migration instance.

41. shipper_migration_cancel_local

Type: action

Fires on migration cancel, just before sending out any remote cancel requests

Arguments: $migration

Arguments:

  • - object
    Shipper_Model_Stored_Migration instance.

42. shipper_migration_cancel

Type: action

Fires on migration cancel

Arguments: $migration

Arguments:

  • - object
    Shipper_Model_Stored_Migration instance.

43. shipper_migration_tick

Type: action

Fires on each completed tick

Arguments: $migration, $task, $status

Arguments:

  • $migration - object
    Migration model instance.

  • $task - object
    Overall task instance.

  • $status - bool
    Migration completion status.

44. shipper_internals_is_in_debug_mode

Type: filter

Debug mode filter

<p>Debug mode affects FS storage implementation and cancels out the concealments/obfuscation for easier debugging.</p>

Arguments: false

Arguments:

  • $is_in_debug_mode -
    bool Defaults to false.

45. heartbeat_settings

Type: filter

No description

Arguments: array()

46. shipper_codec_serialized_recursion_depth

Type: filter

No description

Arguments: 200, $this

47. shipper_path_process_paths_limit

Type: filter

Max number of paths to be processed per step

<p>Number of files processed is directly dependent on this.</p>

Arguments: $limit, $this->is_excludable()

Arguments:

  • $paths_count - int
    Number of paths to process.

  • $is_excludable - bool
    Whether we're excluding files (false means preflight).

48. shipper_path_process_bytes_limit

Type: filter

Max number of bytes to process per step

Arguments: $limit, $this->is_excludable()

Arguments:

  • $bytes - int
    Number of bytes to process.

  • $is_excludable - bool
    Whether we're excluding files (false means preflight).

49. shipper_path_include_file

Type: filter

Whether to actually include this item in list processing

Arguments: true, $item

Arguments:

  • $do_process_item - bool
    Include item.

  • $item - string
    Item path.

50. shipper_api_mock_local

Type: filter

No description

Arguments: false

51. shipper_api_mock_local

Type: filter

No description

Arguments: false

52. shipper_api_mock_local

Type: filter

No description

Arguments: false

53. shipper_paths_working_dir_root

Type: filter

Gets the working directory root path

<p>Defaults to system temp directory, or best guesstimate.</p>

Arguments: get_temp_dir()

Arguments:

  • $root_path - string
    Temporary working directory.

54. shipper_paths_working_dir

Type: filter

Gets the actual working directory path

Arguments: $shipper_dir

Arguments:

  • $shipper_dir - string
    Shipper working directory path.

55. shipper_locks_forbid_stale_checks

Type: filter

Stale locks cleanup check

<p>This is how we decide whether to clear stale locks. We are doing this because clearing &quot;stale&quot; locks messes up the import process if set_time_limit <em>actually</em> does what it's supposed to do, which might not always be the case :(</p>

Arguments: false

Arguments:

  • $forbid_cleanup - bool
    If true, stale locks will not be cleared.

56. shipper_hash_obfuscation_key

Type: filter

Gets the site-specific obfuscation key

Arguments: $key, $fallback

Arguments:

  • $key - string
    Site-specific obfuscation key.

  • $fallback - string
    Optional provided fallback.

57. shipper_codec_domain_include_scheme

Type: filter

Allows for domain-with-scheme macro opting out

Arguments: true

Arguments:

  • $include_scheme_macro - bool
    Whether to include the scheme macro.

58. shipper_log_debug_statements

Type: filter

No description

Arguments: false

59. {$this->get_codec_type())}

Type: filter

No description

Arguments: $this->get_replacements_list()

60. {$this->get_codec_type())}

Type: filter

No description

Arguments: $this->get_replacements_list()

61. {$this->get_codec_type(),}

Type: filter

No description

Arguments: $this->get_original_value($original)

62. shipper_heartbeat_update_interval

Type: filter

Gets the update interval for Heartbeat API

Arguments: 15

Arguments:

  • $update_interval - int, string
    Heartbeat update interval.

63. shipper_assets_shipper_icon

Type: filter

Returns FS path to shipper icon.

<p>Used in tests.</p>

Arguments: plugin_dir_path(SHIPPER_PLUGIN_FILE) . 'assets/img/anchor.svg'

Arguments:

  • $icon_path - string
    Path to icon.

64. wpmudev_branding_hide_branding

Type: filter

No description

Arguments: false

65. wpmudev_branding_hero_image

Type: filter

No description

Arguments: ''

66. wpmudev_branding_footer_text

Type: filter

No description

Arguments: $default

67. wpmudev_branding_hide_doc_link

Type: filter

No description

Arguments: false

68. shipper_kickstart_grace_period

Type: filter

No description

Arguments: 5

69. shipper_max_exec_time

Type: filter

Max exec time before limit optimization

<p>Used in tests.</p>

Arguments: self::$_max_exec_time

Arguments:

  • $time - int
    Maximum execution time.

70. shipper_max_exec_time_capped

Type: filter

Maximum execution time

Arguments: 180

Arguments:

  • $time - int
    Maximum execution time.

71. shipper_helper_system_disabled

Type: filter

Whether a function call is disabled.

<p>Used in tests.</p>

Arguments: !$callable, $func

Arguments:

  • $disabled - bool
    Whether a function call is disabled.

  • $func - string
    Function to check.

72. shipper_helper_system_changeable

Type: filter

Whether an ini key is changeable.

<p>Used in tests.</p>

Arguments: wp_is_ini_value_changeable($what), $what

Arguments:

  • $changeable - bool
    Whether the key is changeable.

  • $what - string
    Ini key to check.

73. shipper_helper_system_safemode

Type: filter

Checks whether we're in PHP safe mode.

<p>Used in tests.</p>

Arguments: !empty($is_safe_mode) && 'off' !== $is_safe_mode

Arguments:

  • $is_in_safe_mode - bool
    Whether we're in safe mode.

74. shipper_import_tables_source_names

Type: filter

Resolved table names, according to unpacked files

<p>Used in tests.</p>

Arguments: $tables

Arguments:

  • $tables - array
    Resolved table names.

75. shipper_import_table_row_values

Type: filter

The row values to be updated in the destination table.

Arguments: $dest_row, $row, $table

Arguments:

  • $dest_row - array
    Processed row values.

  • $row - array
    Source (unprocessed) row.

  • $table - string
    Table that the row belongs to.

76. shipper_destination_table_name

Type: filter

No description

Arguments: $this->get_destination_table()

77. shipper_export_tables_create_{$part}

Type: filter

No description

Arguments: false, $table

78. shipper_export_tables_row_bytes

Type: filter

Row size limit, in bytes

Arguments: $limit, $table

Arguments:

  • $limit - int
    Size, in bytes.

  • $table - string
    Table name.

79. shipper_export_table_include_transients

Type: filter

Whether to include transients in migration

Arguments: true, $raw, $table

Arguments:

  • $include - bool
    Whether to include transients in export.

  • $raw - array
    Raw row hash.

  • $table - string
    Table name.

80. shipper_export_table_include_row

Type: filter

Whether to include this row in migration

Arguments: $include, $raw, $table

Arguments:

  • $include - bool
    Whether to include the row in export.

  • $raw - array
    Raw row hash.

  • $table - string
    Table name.

81. shipper_is_auth_requiring_env

Type: filter

Decide whether we're in an auth-requiring environment.

<p>Used in building ping request arguments to establish runner execution context.</p>

Arguments: \Shipper_Model_Env::is_wp_engine()

Arguments:

  • $is_auth - bool
    Check result this far.

82. shipper_env_is_flywheel

Type: filter

Whether or not we're dealing with Flywheel environment

<p>Used in tests.</p>

Arguments: defined('FLYWHEEL_PLUGIN_DIR')

Arguments:

  • $is_flywheel - bool
    Flywheel environment detected.

83. shipper_thresholds_max_file_size

Type: filter

Maximum individual file size allowed before issuing a warning

Arguments: $max

Arguments:

  • $max - int
    Maximum file size, in bytes.

84. shipper_thresholds_max_package_size

Type: filter

Maximum raw package size allowed before issuing a warning

Arguments: $max

Arguments:

  • $max - int
    Maximum package size, in bytes.

85. shipper_healthcheck_kickstarts_threshold

Type: filter

No description

Arguments: self::THRESHOLD_KICKSTARTS

86. shipper_await_cancel_{$identifier}_max

Type: filter

Cancel await max time

<p>Default 30 secs, in microseconds.</p>

Arguments: (int) ((double) $secs * $micro)

Arguments:

  • $time - int
    Time to spend awaiting cancel lock, in microseconds.

87. shipper_await_cancel_{$identifier}_step

Type: filter

Cancel await step

<p>Default 1 sec, in microseconds.</p>

Arguments: (int) ((double) $step * $micro)

Arguments:

  • $time - int
    Time to spend hibernating between cancel lock checks, in microseconds.

88. shipper_site_uniqid

Type: filter

Gets domain-based unique site identifier

Arguments: preg_replace('/-+/', '-', $id), $prefix

Arguments:

  • $uniqid - string
    Safe-ranged identifier.

  • $prefix - string
    Optional prefix.

89. shipper_dashboard_users

Type: filter

List of users allowed to access WPMU DEV Dashboard

<p>Used in tests.</p>

Arguments: $dash_users

Arguments:

  • $dash_users - array
    A list of users allowed to access WPMU DEV Dashboard.