mkdocs.yml 15.1 KB
Newer Older
1
site_name: Developer Guide
2
repo_url: https://github.com/civicrm/civicrm-dev-docs
3
4
site_description: A guide for CiviCRM developers.
site_author: The CiviCRM community
MikeyMJCO's avatar
MikeyMJCO committed
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
theme: 
  name: material

markdown_extensions:
  - attr_list
  - admonition
  - def_list
  - toc:
      permalink: true
  - pymdownx.highlight:
      guess_lang: true
      extend_pygments_lang:
        - name: php
          lang: php
          options:
            startinline: true
  - pymdownx.superfences:
      css_class: codehilite
  - pymdownx.inlinehilite:
      css_class: codehilite
  - pymdownx.tilde
  - pymdownx.betterem
  - pymdownx.mark
28

MikeyMJCO's avatar
MikeyMJCO committed
29
nav:
30
- Home: index.md
Sean Madsen's avatar
Sean Madsen committed
31
- Basics:
Sean Madsen's avatar
Sean Madsen committed
32
  - Developer Community: basics/community.md
33
  - Requirements: basics/requirements.md
Sean Madsen's avatar
Sean Madsen committed
34
35
  - Useful Skills: basics/skills.md
  - Planning Your Project: basics/planning.md
Sean Madsen's avatar
Sean Madsen committed
36
- Tools:
Sean Madsen's avatar
Sean Madsen committed
37
  - Development Tools: tools/index.md
Sean Madsen's avatar
Sean Madsen committed
38
39
40
  - Buildkit: tools/buildkit.md
  - civibuild: tools/civibuild.md
  - cividist: tools/cividist.md
mickadoo's avatar
mickadoo committed
41
  - civilint: tools/civilint.md
42
  - civi-test-run: tools/civi-test-run.md
43
44
  - Issue Tracking: tools/issue-tracking.md
  - Git, GitHub, & GitLab: tools/git.md
45
  - Jenkins: tools/jenkins.md
46
47
  - PhpStorm: tools/phpstorm.md
  - Debugging: tools/debugging.md
totten's avatar
totten committed
48
  - Universe: tools/universe.md
Sean Madsen's avatar
Sean Madsen committed
49
- Core:
Sean Madsen's avatar
Sean Madsen committed
50
51
  - When to Edit Core: core/hacking.md
  - How to Contribute: core/contributing.md
wmortada's avatar
wmortada committed
52
  - Reviewing a PR: core/pr-review.md
53
  - Verifying a Bug Fix: core/verify-fix.md
54
  - Release Process: core/release-process.md
JoeMurray's avatar
JoeMurray committed
55
56
- Financial:
  - Overview: financial/overview.md
MikeyMJCO's avatar
MikeyMJCO committed
57
58
  - Order API: financial/orderAPI.md
  - Payment API: financial/paymentAPI.md
MikeyMJCO's avatar
MikeyMJCO committed
59
  - Entities: financial/financialentities.md
Sean Madsen's avatar
Sean Madsen committed
60
- Extensions:
Sean Madsen's avatar
Sean Madsen committed
61
  - Basics: extensions/index.md
Sean Madsen's avatar
Sean Madsen committed
62
  - Packaging Options: extensions/packaging.md
Sean Madsen's avatar
Sean Madsen committed
63
  - civix: extensions/civix.md
64
  - Extension Structure: extensions/structure.md
Sean Madsen's avatar
Sean Madsen committed
65
  - info.xml File: extensions/info-xml.md
Sean Madsen's avatar
Sean Madsen committed
66
  - Publishing Extensions: extensions/publish.md
67
  - Extension Lifecycle: extensions/lifecycle.md
Sean Madsen's avatar
Sean Madsen committed
68
  - Troubleshooting: extensions/troubleshooting.md
Sean Madsen's avatar
Sean Madsen committed
69
  - Advanced Patterns: extensions/advanced.md
Sean Madsen's avatar
Sean Madsen committed
70
71
  - Payment Processors:
    - Payment Processors: extensions/payment-processors/index.md
72
    - Payment Processor Types: extensions/payment-processors/types.md
Sean Madsen's avatar
Sean Madsen committed
73
    - Creating a Payment Processor: extensions/payment-processors/create.md
74
  - CMS-specific development: extensions/cms-specific.md
75
- API:
Seamus Lee's avatar
Seamus Lee committed
76
77
  - API Intro: api/index.md
  - API Interfaces: api/interfaces.md
78
79
  - APIv4:
    - APIv4 Usage: api/v4/usage.md
80
    - APIv4 Actions: api/v4/actions.md
81
82
    - APIv4 Joins: api/v4/joins.md
    - APIv4 Chaining: api/v4/chaining.md
83
    - APIv4 Custom Data: api/v4/custom-data.md
colemanw's avatar
colemanw committed
84
    - APIv4 Architecture: api/v4/architecture.md
colemanw's avatar
colemanw committed
85
    - Differences Between Api v3 and v4: api/v4/differences-with-v3.md
86
    - APIv4 Changelog: api/v4/changes.md
Seamus Lee's avatar
Seamus Lee committed
87
88
89
90
91
92
93
94
  - APIv3:
    - APIv3 Usage: api/v3/usage.md
    - APIv3 Actions: api/v3/actions.md
    - APIv3 Options: api/v3/options.md
    - APIv3 Joins: api/v3/joins.md
    - APIv3 Chaining: api/v3/chaining.md
    - APIv3 Custom Data: api/v3/custom-data.md
    - APIv3 Examples: api/v3/examples.md
95
    - APIv3 Changelog: api/v3/changes.md
MikeyMJCO's avatar
MikeyMJCO committed
96
    - WordPress REST Interface: api/v3/wp-rest.md
97
- Hooks:
98
  - Hooks Introduction: hooks/index.md
99
  - Hooks Changelog: hooks/changes.md
100
  - Usage:
ayduns's avatar
ayduns committed
101
102
103
104
105
    - Hooks in Extensions: hooks/usage/extension.md
    - Hooks in Symfony: hooks/usage/symfony.md
    - Hooks in Drupal: hooks/usage/drupal.md
    - Hooks in Joomla: hooks/usage/joomla.md
    - Hooks in WordPress: hooks/usage/wordpress.md
106
  - All Hooks: hooks/list.md
Sean Madsen's avatar
Sean Madsen committed
107
  - Batch Hooks:
Andie Hunt's avatar
Andie Hunt committed
108
109
    - hook_civicrm_batchItems: hooks/hook_civicrm_batchItems.md
    - hook_civicrm_batchQuery: hooks/hook_civicrm_batchQuery.md
Sean Madsen's avatar
Sean Madsen committed
110
  - Case Hooks:
Andie Hunt's avatar
Andie Hunt committed
111
112
113
114
    - hook_civicrm_caseChange: hooks/hook_civicrm_caseChange.md
    - hook_civicrm_caseTypes: hooks/hook_civicrm_caseTypes.md
    - hook_civicrm_post_case_merge: hooks/hook_civicrm_post_case_merge.md
    - hook_civicrm_pre_case_merge: hooks/hook_civicrm_pre_case_merge.md
Sean Madsen's avatar
Sean Madsen committed
115
  - Database Hooks:
116
    - hook_civicrm_alterLocationMergeData: hooks/hook_civicrm_alterLocationMergeData.md
117
118
119
120
121
    - hook_civicrm_copy: hooks/hook_civicrm_copy.md
    - hook_civicrm_custom: hooks/hook_civicrm_custom.md
    - hook_civicrm_managed: hooks/hook_civicrm_managed.md
    - hook_civicrm_merge: hooks/hook_civicrm_merge.md
    - hook_civicrm_post: hooks/hook_civicrm_post.md
totten's avatar
totten committed
122
    - hook_civicrm_postCommit: hooks/hook_civicrm_postCommit.md
Andie Hunt's avatar
Andie Hunt committed
123
    - hook_civicrm_postSave_table_name: hooks/hook_civicrm_postSave_table_name.md
124
125
    - hook_civicrm_pre: hooks/hook_civicrm_pre.md
    - hook_civicrm_referenceCounts: hooks/hook_civicrm_referenceCounts.md
126
127
128
129
    - hook_civicrm_triggerInfo: hooks/hook_civicrm_triggerInfo.md
  - Dedupe Hooks:
    - hook_civicrm_dupeQuery: hooks/hook_civicrm_dupeQuery.md
    - hook_civicrm_findDuplicates: hooks/hook_civicrm_findDuplicates.md
Sean Madsen's avatar
Sean Madsen committed
130
  - Entity Hooks:
Andie Hunt's avatar
Andie Hunt committed
131
    - hook_civicrm_entityTypes: hooks/hook_civicrm_entityTypes.md
Matthew Wire's avatar
Matthew Wire committed
132
  - Extension Lifecycle Hooks:
133
134
135
    - hook_civicrm_disable: hooks/hook_civicrm_disable.md
    - hook_civicrm_enable: hooks/hook_civicrm_enable.md
    - hook_civicrm_install: hooks/hook_civicrm_install.md
Andie Hunt's avatar
Andie Hunt committed
136
    - hook_civicrm_postInstall: hooks/hook_civicrm_postInstall.md
137
138
    - hook_civicrm_uninstall: hooks/hook_civicrm_uninstall.md
    - hook_civicrm_upgrade: hooks/hook_civicrm_upgrade.md
Sean Madsen's avatar
Sean Madsen committed
139
  - Form Hooks:
140
    - hook_civicrm_alterAngular: hooks/hook_civicrm_alterAngular.md
141
    - hook_civicrm_alterContent: hooks/hook_civicrm_alterContent.md
Andie Hunt's avatar
Andie Hunt committed
142
    - hook_civicrm_alterTemplateFile: hooks/hook_civicrm_alterTemplateFile.md
143
    - hook_civicrm_buildForm: hooks/hook_civicrm_buildForm.md
Andie Hunt's avatar
Andie Hunt committed
144
    - hook_civicrm_idsException: hooks/hook_civicrm_idsException.md
145
146
    - hook_civicrm_postProcess: hooks/hook_civicrm_postProcess.md
    - hook_civicrm_preProcess: hooks/hook_civicrm_preProcess.md
147
    - <del>hook_civicrm_validate</del>: hooks/hook_civicrm_validate.md
Andie Hunt's avatar
Andie Hunt committed
148
    - hook_civicrm_validateForm: hooks/hook_civicrm_validateForm.md
Sean Madsen's avatar
Sean Madsen committed
149
  - GUI Hooks:
150
    - hook_civicrm_activeTheme: hooks/hook_civicrm_activeTheme.md
Pradeep Nayak's avatar
Typo    
Pradeep Nayak committed
151
    - hook_civicrm_alterCustomFieldDisplayValue: hooks/hook_civicrm_alterCustomFieldDisplayValue.md
152
    - hook_civicrm_alterEntityRefParams: hooks/hook_civicrm_alterEntityRefParams.md
Andie Hunt's avatar
Andie Hunt committed
153
    - hook_civicrm_alterMenu: hooks/hook_civicrm_alterMenu.md
154
155
    - hook_civicrm_buildAmount: hooks/hook_civicrm_buildAmount.md
    - hook_civicrm_caseSummary: hooks/hook_civicrm_caseSummary.md
Andie Hunt's avatar
Andie Hunt committed
156
    - hook_civicrm_contact_get_displayname: hooks/hook_civicrm_contact_get_displayname.md
157
    - <del>hook_civicrm_customFieldOptions</del>: hooks/hook_civicrm_customFieldOptions.md
158
    - hook_civicrm_dashboard: hooks/hook_civicrm_dashboard.md
Andie Hunt's avatar
Andie Hunt committed
159
    - hook_civicrm_dashboard_defaults: hooks/hook_civicrm_dashboard_defaults.md
MikeyMJCO's avatar
MikeyMJCO committed
160
    - hook_civicrm_entityRefFilters: hooks/hook_civicrm_entityRefFilters.md
Andie Hunt's avatar
Andie Hunt committed
161
    - hook_civicrm_fieldOptions: hooks/hook_civicrm_fieldOptions.md
162
163
164
165
166
167
168
    - hook_civicrm_links: hooks/hook_civicrm_links.md
    - hook_civicrm_navigationMenu: hooks/hook_civicrm_navigationMenu.md
    - hook_civicrm_pageRun: hooks/hook_civicrm_pageRun.md
    - hook_civicrm_searchColumns: hooks/hook_civicrm_searchColumns.md
    - hook_civicrm_searchTasks: hooks/hook_civicrm_searchTasks.md
    - hook_civicrm_summary: hooks/hook_civicrm_summary.md
    - hook_civicrm_summaryActions: hooks/hook_civicrm_summaryActions.md
Seamus Lee's avatar
Seamus Lee committed
169
    - hook_civicrm_themes: hooks/hook_civicrm_themes.md
170
    - <del>hook_civicrm_tabs</del>: hooks/hook_civicrm_tabs.md
171
    - hook_civicrm_tabset: hooks/hook_civicrm_tabset.md
Andie Hunt's avatar
Andie Hunt committed
172
    - hook_civicrm_xmlMenu: hooks/hook_civicrm_xmlMenu.md
Sean Madsen's avatar
Sean Madsen committed
173
  - Mail Hooks:
Andie Hunt's avatar
Andie Hunt committed
174
175
    - hook_civicrm_alterMailContent: hooks/hook_civicrm_alterMailContent.md
    - hook_civicrm_alterMailer: hooks/hook_civicrm_alterMailer.md
176
    - hook_civicrm_alterMailParams: hooks/hook_civicrm_alterMailParams.md
177
    - hook_civicrm_alterMailingRecipients: hooks/hook_civicrm_alterMailingRecipients.md
178
179
180
181
182
    - hook_civicrm_emailProcessor: hooks/hook_civicrm_emailProcessor.md
    - hook_civicrm_emailProcessorContact: hooks/hook_civicrm_emailProcessorContact.md
    - hook_civicrm_mailingGroups: hooks/hook_civicrm_mailingGroups.md
    - hook_civicrm_postEmailSend: hooks/hook_civicrm_postEmailSend.md
    - hook_civicrm_postMailing: hooks/hook_civicrm_postMailing.md
Andie Hunt's avatar
Andie Hunt committed
183
    - hook_civicrm_unsubscribeGroups: hooks/hook_civicrm_unsubscribeGroups.md
184
185
186
  - Membership Hooks:
    - hook_civicrm_alterCalculatedMembershipStatus: hooks/hook_civicrm_alterCalculatedMembershipStatus.md
    - hook_civicrm_membershipTypeValues: hooks/hook_civicrm_membershipTypeValues.md
Sean Madsen's avatar
Sean Madsen committed
187
  - Permission Hooks:
188
189
190
    - hook_civicrm_aclGroup: hooks/hook_civicrm_aclGroup.md
    - hook_civicrm_aclWhereClause: hooks/hook_civicrm_aclWhereClause.md
    - hook_civicrm_alterAPIPermissions: hooks/hook_civicrm_alterAPIPermissions.md
191
    - hook_civicrm_notePrivacy: hooks/hook_civicrm_notePrivacy.md
192
    - hook_civicrm_permission: hooks/hook_civicrm_permission.md
Andie Hunt's avatar
Andie Hunt committed
193
    - hook_civicrm_permission_check: hooks/hook_civicrm_permission_check.md
194
    - hook_civicrm_selectWhereClause: hooks/hook_civicrm_selectWhereClause.md
Sean Madsen's avatar
Sean Madsen committed
195
  - Profile Hooks:
Andie Hunt's avatar
Andie Hunt committed
196
197
198
199
200
201
    - hook_civicrm_buildProfile: hooks/hook_civicrm_buildProfile.md
    - hook_civicrm_buildUFGroupsForModule: hooks/hook_civicrm_buildUFGroupsForModule.md
    - hook_civicrm_processProfile: hooks/hook_civicrm_processProfile.md
    - hook_civicrm_searchProfile: hooks/hook_civicrm_searchProfile.md
    - hook_civicrm_validateProfile: hooks/hook_civicrm_validateProfile.md
    - hook_civicrm_viewProfile: hooks/hook_civicrm_viewProfile.md
Sean Madsen's avatar
Sean Madsen committed
202
  - Report Hooks:
Andie Hunt's avatar
Andie Hunt committed
203
    - hook_civicrm_alterReportVar: hooks/hook_civicrm_alterReportVar.md
Sean Madsen's avatar
Sean Madsen committed
204
  - SMS Hooks:
205
    - hook_civicrm_inboundSMS: hooks/hook_civicrm_inboundSMS.md
206
207
208
209
  - Scheduled Job / cron Hooks:
    - hook_civicrm_cron: hooks/hook_civicrm_cron.md
    - hook_civicrm_preJob: hooks/hook_civicrm_preJob.md
    - hook_civicrm_postJob: hooks/hook_civicrm_postJob.md
Sean Madsen's avatar
Sean Madsen committed
210
  - Uncategorized Hooks:
211
    - hook_civicrm_alterBadge: hooks/hook_civicrm_alterBadge.md
Andie Hunt's avatar
Andie Hunt committed
212
    - hook_civicrm_alterBarcode: hooks/hook_civicrm_alterBarcode.md
213
    - hook_civicrm_alterExternUrl: hooks/hook_civicrm_alterExternUrl.md
Andie Hunt's avatar
Andie Hunt committed
214
215
    - hook_civicrm_alterLogTables: hooks/hook_civicrm_alterLogTables.md
    - hook_civicrm_alterMailingLabelParams: hooks/hook_civicrm_alterMailingLabelParams.md
216
217
218
    - hook_civicrm_alterPaymentProcessorParams: hooks/hook_civicrm_alterPaymentProcessorParams.md
    - hook_civicrm_alterSettingsFolders: hooks/hook_civicrm_alterSettingsFolders.md
    - hook_civicrm_alterSettingsMetaData: hooks/hook_civicrm_alterSettingsMetaData.md
219
    - hook_civicrm_alterUFFIelds: hooks/hook_civicrm_alterUFFields.md
Andie Hunt's avatar
Andie Hunt committed
220
    - hook_civicrm_angularModules: hooks/hook_civicrm_angularModules.md
221
    - hook_civicrm_apiWrappers: hooks/hook_civicrm_apiWrappers.md
222
    - hook_civicrm_buildAsset: hooks/hook_civicrm_buildAsset.md
223
    - hook_civicrm_buildStateProvinceForCountry: hooks/hook_civicrm_buildStateProvinceForCountry.md
Andie Hunt's avatar
Andie Hunt committed
224
    - hook_civicrm_check: hooks/hook_civicrm_check.md
225
    - hook_civicrm_config: hooks/hook_civicrm_config.md
226
    - <del>hook_civicrm_contactListQuery</del>: hooks/hook_civicrm_contactListQuery.md
Andie Hunt's avatar
Andie Hunt committed
227
228
229
230
    - hook_civicrm_container: hooks/hook_civicrm_container.md
    - hook_civicrm_coreResourceList: hooks/hook_civicrm_coreResourceList.md
    - hook_civicrm_crudLink: hooks/hook_civicrm_crudLink.md
    - hook_civicrm_eventDiscount: hooks/hook_civicrm_eventDiscount.md
231
    - hook_civicrm_export: hooks/hook_civicrm_export.md
Andie Hunt's avatar
Andie Hunt committed
232
233
    - hook_civicrm_fileSearches: hooks/hook_civicrm_fileSearches.md
    - hook_civicrm_geocoderFormat: hooks/hook_civicrm_geocoderFormat.md
234
    - hook_civicrm_getAssetUrl: hooks/hook_civicrm_getAssetUrl.md
235
    - hook_civicrm_import: hooks/hook_civicrm_import.md
Andie Hunt's avatar
Andie Hunt committed
236
    - <del>hook_civicrm_optionValues</del>: hooks/hook_civicrm_optionValues.md
237
    - hook_civicrm_postIPNProcess: hooks/hook_civicrm_postIPNProcess.md
Andie Hunt's avatar
Andie Hunt committed
238
    - hook_civicrm_queryObjects: hooks/hook_civicrm_queryObjects.md
239
    - hook_civicrm_recent: hooks/hook_civicrm_recent.md
Andie Hunt's avatar
Andie Hunt committed
240
241
    - hook_civicrm_tokens: hooks/hook_civicrm_tokens.md
    - hook_civicrm_tokenValues: hooks/hook_civicrm_tokenValues.md
242
    - hook_civicrm_unhandledException: hooks/hook_civicrm_unhandledException.md
243
- Testing:
244
  - Testing: testing/index.md
245
  - Continuous Integration: testing/continuous-integration.md
246
247
  - PHP:
    - PHPUnit Tests: testing/phpunit.md
248
    # - Codeception Tests: testing/codeception.md
249
250
251
    - Selenium Tests: testing/selenium.md
  - Javascript:
    - Karma Tests: testing/karma.md
252
    # - Protractor Tests: testing/protractor.md
253
254
255
256
    - QUnit Tests: testing/qunit.md
  - Other:
    - Upgrade Tests: testing/upgrades.md
    - Manual Tests: testing/manual.md
257
258
259
260
261
262
263
- Security:
  - Secure Coding: security/index.md
  - Securing Inputs: security/inputs.md
  - Securing Outputs: security/outputs.md
  - Permissions: security/permissions.md
  - Access Control: security/access.md
  - Reporting Vulnerabilities: security/reporting.md
totten's avatar
totten committed
264
- Framework:
265
266
267
268
269
270
271
272
273
274
275
  - AJAX Pages and Forms Reference: framework/ajax.md
  - AngularJS:
    - AngularJS Intro: framework/angular/index.md
    - AngularJS Quick Start: framework/angular/quickstart.md
    - AngularJS File Names: framework/angular/files.md
    - AngularJS Loader: framework/angular/loader.md
    - AngularJS Changesets:  framework/angular/changeset.md
  - Asset Builder: framework/asset-builder.md
  - Bootstrap Process: framework/bootstrap.md
  - Backbone Reference: framework/backbone.md
  - Cache Reference: framework/cache.md
Sean Madsen's avatar
Sean Madsen committed
276
  - CiviMail: framework/civimail.md
277
  - CiviReport: framework/civireport.md
278
  - Codebase: framework/codebase.md
279
280
281
282
283
  - Database:
    - Overview: framework/database/index.md
    - XML Schema definition: framework/database/schema-definition.md
    - Schema Design: framework/database/schema-design.md
    - Transaction Reference: framework/database/transactions.md
284
  - File System: framework/filesystem.md
285
286
287
288
  - PseudoConstant Reference: framework/pseudoconstant.md
  - QuickForm Reference:
     - QuickForm: framework/quickform/index.md
     - Entity Reference Field: framework/quickform/entityref.md
Rich's avatar
Rich committed
289
  - Queue Reference: framework/queues/index.md
290
  - Region Reference: framework/region.md
Sean Madsen's avatar
Sean Madsen committed
291
  - Routing: framework/routing.md
292
293
  - Resources Reference: framework/resources.md
  - Setting Reference: framework/setting.md
totten's avatar
totten committed
294
295
296
297
298
299
  - Setup Reference:
    - Overview: framework/setup/index.md
    - Getting Started: framework/setup/getting-started.md
    - New Installer: framework/setup/new-installer.md
    - New Plugin: framework/setup/new-plugin.md
    - Manage Plugins: framework/setup/plugins.md
300
301
302
303
  - Template Reference:
    - Templates: framework/templates/index.md
    - Customizing Templates: framework/templates/customizing.md
    - Extending Smarty: framework/templates/extending-smarty.md
totten's avatar
totten committed
304
  - Theme Reference: framework/theme.md
305
  - Token Reference: framework/token.md
306
307
  - UI Reference: framework/ui.md
  - Upgrade Reference: framework/upgrade.md
bgm's avatar
bgm committed
308
- Translation:
309
  - Translation: translation/index.md
bgm's avatar
bgm committed
310
311
  - Extensions Translation: translation/extensions.md
  - Database localized fields and upgrades: translation/database.md
totten's avatar
totten committed
312
- Standards:
313
314
315
316
317
  - Coding Standards: standards/index.md
  - PHP Standards: standards/php.md
  - Javascript Standards: standards/javascript.md
  - Database Standards: standards/database.md
  - Review Standards: standards/review.md
318
- Documentation:
Sean Madsen's avatar
Sean Madsen committed
319
  - Writing Documentation: documentation/index.md
320
  - Documenting Extensions: documentation/extensions.md
Sean Madsen's avatar
Sean Madsen committed
321
  - Markdown: documentation/markdown.md
Sean Madsen's avatar
Sean Madsen committed
322
  - Style Guide: documentation/style-guide.md
MikeyMJCO's avatar
MikeyMJCO committed
323