1. Custom
forma+ers
Jochen
Verdeyen
Nicolas
Leroy
1.

2. Who are we?
! Nicolas Leroy
¬ http://drupal.org/user/3527
¬ @nicolasleroy
¬ http://nicolasleroy.be
! Jochen Verdeyen
¬ http://drupal.org/user/310720
¬ http://www.jover.be/
2.

3. Agenda
! Custom Formatters in Drupal 6 (CCK)
¬ Using custom formatters module
¬ Writing custom code
! Example: HR site
! Custom Formatters in Drupal 7 (Core: Field API)
¬ Using custom formatters module
¬ Writing custom code
! Difference D6 – D7
! Example: Coordinates – Google Static Maps
3.

4. 4.

5. Custom Formatters in D6
! A custom formatter can be used to change the output of a
CCK field.
! Example: filefield
5.

6. CCK – Filefield Formatters
! Go to the filefield module
¬ Filefield.module (hook_field_formatter_info,
hook_theme)
¬ Filefield_formatter.inc (theme hooks)
6.

7. CCK – Filefield Formatters
7.

8. How to add a custom formatter?
! Use the “custom formatters” module
¬ http://drupal.org/project/custom_formatters
! Write custom code
8.

9. Use the Custom Formatter module
9.

10. Your custom formatter
10.

11. Write custom code
11.

12. Write custom code
! hook_field_formatter_info (CCK)
¬ Declares information about one or more field formatter types.
! hook_theme
¬ Register a module (or theme’s) theme implementation.
! theme_hook
¬ Generate a themed output.
12.

13. Example
! Real-life problem: Job section
¬ Job postings on website
¬ Applications online, saved as node
¬ View to show applications
¬ Some file names too long to display
! http://my.www.devdays.be
13.

14. Example: problem
14.

15. Example: solution
15.

16. 16.

17. Custom Formatters in D7
! Custom Formatters module
! Write custom code
¬ Coordinates Field module
¬ Coordinates Formatter module
17.

18. Coordinates Field module
Form
Formatted
18.

19. Write custom code
! hook_theme
! hook_field_formatter_info
¬ D6: CCK hook_field_formatter_info
¬ CCK à D7 Field API
! hook_field_formatter_info_alter
! hook_field_formatter_view
! hook_field_formatter_prepare_view
! hook_field_formatter_settings_form
! hook_field_formatter_settings_summary
! http://api.drupal.org
19.

20. hook_theme
google-static-map.tpl.php
20.

21. hook_field_formatter_info
Default values
21.

22. hook_field_formatter_view
coordinates
formatter settings
Google Static Map API implementation
return variables
22.

23. hook_field_formatter_settings_form
23.

24. hook_field_formatter_settings_summary
24.

25. 25.

26. 26.