A short presentation on Paragraphs and Drupal - how to build multi-field entities in Drupal for your complex content types and display schemas.

1. PARAGRAPHSTHE
CAKE
ERIC SCOTT SEMBRAT (@ESEMBRAT)

3. ERIC SEMBRAT
Web Manager @ Georgia Tech
President @ Atlanta Drupal Users Group
Graduate Student @ Georgia State Univ.
Hi, my name is…

4. WEBBEH.COM
FIND ME AT @ESEMBRAT, OR VISIT

5. SO…WHAT’S OUR
GOAL FOR
TODAY?

6. 1.LEARN MORE ABOUT
THE HISTORY OF
CONTENT GLOBBING
IN DRUPAL.

7. 2.LEARN WHAT THE
HECK PARAGRAPHS
ARE AND HOW THEY
ARE UTILIZED.

8. 3.LEARN HOW TO
SETUP, STRUCTURE,
& SHOW THOSE
PARAGRAPHS.

9. 4.DISCOVER NEXT
STEPS, EXPERT
USAGE, & GENERAL
DRUPAL CRAZINESS.

10. A
DISCLAIM
ER

11. LET US GET
STARTED.

12. OUR TIME
MACHINE
LET’S TAKE A STEP BACK IN

13. (THIS IS DRUPAL 7)

14. HOWHAVE WE BUILT
CONTENT TYPES
TO BE SCALABLE
FOR COMPLEX
CONTENT?

15. FAIL
MORE
IMPORTANTLY,
HOW DO THEY
?

16. WE STARTED WITH…
FIELDS(TONS OF ‘EM)

17. MESSY.
FIELDS ARE GREAT.
BUT, IN LARGE
NUMBERS THEY’RE

18. DELTA.
IMAGINE BUILDING
MULTI-FIELD DATA
FIELDS BY ITS

19. WE STUMBLED UPON…
FIELD COLLECTION

20. ENTITIES.
FIELD
COLLECTIONS
COUPLE FIELDS
INTO DISTINCT

21. TYPE.
HOWEVER, YOU CAN
ONLY POINT TO ONE
FIELD COLLECTION

22. LIMITED.
YOUR OPTIONS FOR
ENTITY EDIT VIEW
OF THE COLLECTION
IS (INCREDIBLY)

23. WE CAME ACROSS…
ENTITY REFERENCE

24. FIELDS.
ENTITY REFERENCE
ALLOWS THE ABILITY
TO COUPLE ENTITIES
TOGETHER THROUGH

25. REUSABLE.
ENTITY REFERENCE
IS MEANT TO BE

26. MULTIPLE
ENTITY REFERENCE
ALLOWS YOU TO
SELECT FROM
ENTITY TYPES AT
ONCE.

27. VIEWS.
YOU CAN EVEN JUMP
THROUGH THE
RELATIONSHIP THROUGH
THE MAGIC OF

28. BUT,

29. CHILDREN
ENTITY REFERENCE*
REQUIRES THAT YOU
DEFINE
BEFORE THE
PARENT.

30. THESE ENTITY
REFERENCES
APPEARALONGSIDE ALL OF YOUR
OTHER CONTENT.

32. SO.

33. COMBINE
WHAT IF WE COULD
FROM EACH OPTION
WHAT WE
LOVE?

34. EASY TO SET UP AND
INSERT
(FIELDS)
EXTENDIBLE &
EMBEDDABLE IN
ENTITIES
(FIELD COLLECTION)
STACKABLE &
FLEXIBLE TO VARIOUS
ENTITY TYPES
(ENTITY REFERENCE)

35. EASY TO SET UP AND
INSERT
(FIELDS)
EXTENDIBLE &
EMBEDDABLE IN
ENTITIES
(FIELD COLLECTION)
STACKABLE &
FLEXIBLE TO VARIOUS
ENTITY TYPES
(ENTITY REFERENCE)
THE PERFECT MIX.

36. EASY TO SET UP AND
INSERT
(FIELDS)
EXTENDIBLE &
EMBEDDABLE IN
ENTITIES
(FIELD COLLECTION)
STACKABLE &
FLEXIBLE TO VARIOUS
ENTITY TYPES
(ENTITY REFERENCE)
PARAGRAPHS

37. SHOW ME THE
PARAGRAPHS.

38. ALL ABOUT
PARAGRAPHS

39. https://www.drupal.org/project/paragraphs

40. DRUPAL 8.
FRIENDLY FOR
AS WELL AS OUR OLD
FRIEND…
DRUPAL 7.

41. BUILTFOR FLEXIBLE AND
MULTI-FIELD
COMPONENTS FOR
ENTITIES.

42. BUILD?WHAT CAN
YOU

43. SLIDESHOWS.

44. METADATA.

45. HEAVY-DUTY
FIELDS.

46. MULTI-LAYER
CONTENT.

47. VARIABLE
DATA ENTRY.

48. AND MORE!

49. PARAGRAPHS
CONFIGURING & USING

50. USING
LET’S TALK ABOUT
PARAGRAPHS.

53. ENTITY
THIS SHOULD LOOK
IDENTICAL TO YOUR
EXPERIENCE.

54. CONNECT
THE DIFFERENCE
IS HOW YOU
A PARAGRAPH TO YOUR
ENTITY OF CHOICE.

62. INCEPTION.
CONFIGURATION IS PRETTY
STRAIGHTFORWARD
THE MAGIC COMES IN
WITH

63. EACH CONTAINER IS
A PARAGRAPH.
SO IS EACH
CONTAINER OBJECT.
(IN THIS EXAMPLE)

65. Level 1

66. Level 1
Level 2

67. Level 1
Level 2
Level 1

68. Level 1
Level 2
Level 1
And onwards down the page!

69. DISPLAY?
HOW ABOUT

70. GENERIC.
DRUPAL RENDERS
PARAGRAPHS JUST LIKE
ANY OTHER ENTITY…

71. VIEWS
OTHER METHODS FOR
EMBEDDING PARAGRAPHS
INCLUDE:

72. PANELS
OTHER METHODS FOR
EMBEDDING PARAGRAPHS
INCLUDE:

73. .TPL.PHP
OTHER METHODS FOR
EMBEDDING PARAGRAPHS
INCLUDE:

74. .TWIG
OTHER METHODS FOR
EMBEDDING PARAGRAPHS
INCLUDE:

75. OTHER DISPLAY
SUITES
OTHER METHODS FOR
EMBEDDING PARAGRAPHS
INCLUDE:

76. EXAMPLE…
IN MY PAGE STRUCTURE

77. Panel Page Override
View (container)
View (container content)

78. Panel Page Override
View (container)
View (container content)
Let your data design
determine the best way
for a display.

79. PARAGRAPHS?
SO, HOW WOULD YOU USE
STRUCTURE, CONTENT,
METADATA, ETC?

80. EXPORT
OH YEAH, AND YOU CAN
STRUCTURE VIA FEATURES.

81. PARAGRAPHS
EXTENDING & COMPANIONS FOR

82. SUB-PROJECTS
LET’S EXPLORE A FEW
THAT EXTEND
PARAGRAPHS EVEN
FURTHER BEYOND.

83. PARAGRAPHS PACK
COMMON “GETTING
STARTED” PARAGRAPH
BUNDLES TO EXPERIMENT
WITH.

84. CLASSY PARAGRAPHS
ADDS A CUSTOM-
PREDEFINED CSS CLASS TO
EACH PARAGRAPH
INSTANCE.

85. EDGY
LEVERAGES BOOTSTRAP
TO PROVIDE EDGE-TO-EDGE
CAPABILITY FOR A
PARAGRAPH ITEM.

86. PARAGRAPH
DEFAULTS
ALLOWS SET OF DEFAULT
VALUES FOR A NEW
PARAGRAPH INSTANCE.
BULK REPLACE/APPLY.

87. PARAGRAPH ID
ADDS UNIQUE PARAGRAPH
ID TO DEFAULT DISPLAY
MARKUP.

88. FEATURE EXPORTS
LEAN TO THE COMMUNITY
FOR EXAMPLES, EXPORTS
OF PARAGRAPH DESIGNS.

89. LEARNED?
SO, WHAT HAVE WE

90. FIELD BUNDLING
OPTIONS IN DRUPAL
FIELD COLLECTION, ENTITY
REFERENCE, & PARAGRAPHS.
PROS AND CONS OF EACH.

91. PARAGRAPHS 101
WHAT IS A PARAGRAPH?
WHAT IS IT GOOD FOR?

92. USING PARAGRAPHS
A QUICK PRIMER ON SETUP,
CONFIGURATION, AND
STRUCTURING.

93. EXTENDING
PARAGRAPHS ON
HELPER SECONDARY
MODULES FOR PARAGRAPHS.

94. FIN.

95. QS?

96. esembrat