How to theme a paragraph bundle with a template file?

Question

I am using the Paragraphs module version 7.x-1.0-beta6 I have a bundle with the machine name: text_buttons

In the paragraphs module there are two theme suggestions:

 paragraphs-items.tpl.php
 paragraphs-item.tpl.php

if I copy paragraphs-items.tpl.php to my template folder under my theme, i can modify the code and see the changes reflect site wide wherever there is a paragraph bundle.

Now when I go to target a specific paragraph bundle nothing happens at all. I've followed the solutions in the following threads:

• https://www.drupal.org/node/2326443
• https://www.drupal.org/node/2481339
• https://www.drupal.org/node/2399631

Nothing seems to work. Is the module currently broken? do I have to implement some sort of theme hook? I've made sure to flush caches on every change just to ensure I would be seeing the template file but it doesn't work, I've never had a problem with finding theme names before.. The documentation is non-existent for this module, and i really don't want to dig into the module code right now.

Another thing to note is that paragraphs-item.tpl.php does nothing on my website from either the module or my theme directory. it seems only paragraphs-items.tpl.php works out of the box.

I've tried:

paragraphs-items--text-buttons.tpl.php
paragraphs-items--text_buttons.tpl.php
paragraphs-items-text-buttons.tpl.php
paragraphs-items-text_buttons.tpl.php

field--paragraphs-items--text-buttons.tpl.php
field-paragraphs-items--text-buttons.tpl.php
field--paragraphs-items--text_buttons.tpl.php
field-paragraphs-items--text_buttons.tpl.php

field--paragraphs-items-text-buttons.tpl.php
field-paragraphs-items-text-buttons.tpl.php
field--paragraphs-items-text_buttons.tpl.php
field-paragraphs-items-text_buttons.tpl.php

Anyone have an idea why I can't theme my paragraph bundles?

Answer 1

I had the same question. Here's what worked for me with: Drupal 7.41, Paragraphs 7.x-1.0-rc4.

1. Go to the end of your settings.php file and remove the hash sign to enable "$conf['theme_debug'] = TRUE;" Or add the line if not present.
2. Flush your cache.
3. With your favorite browser, inspect the Paragraph output that you want to override. You should now have HTML comments, just before the actual markup, with template filename suggestions that you can use in your theme.

With my setup, the template filename suggestions are:

paragraphs-items--{field name}--{view mode}.tpl.php
paragraphs-items--{field name}.tpl.php
paragraphs-items.tpl.php

Where field name is the name of the field you use when you assign the paragraph field to a content type (not the Paragraph bundle name).

So in your particular case, if the paragraph field happened to be named "text-buttons" (machine name "field_text_buttons"), the filename suggestions are:

paragraphs-items--field-text-buttons--full.tpl.php
paragraphs-items--field-text-buttons.tpl.php
paragraphs-items.tpl.php

Don't forget to turn off theme debugging on your production site.

Best of luck.

Answer 2

You were soo close, but there is no s in item when using bundle.

paragraphs-item--[bundle-name].tpl.php

so for you:

paragraphs-item--text-buttons.tpl.php

---

You can add the view mode if you want:

paragraphs-item--[bundle-name]--[view-mode].tpl.php

Answer 3

If you have the Edgy module installed the template prefix is edgy-.

So in your case it would be edgy-paragraphs-item--text-buttons.tpl.php

Edgy:

Edgy allows site builders to display Paragraph items edge-to-edge. It does this by controlling the placement of the .container Bootstrap class.

Using a combination of Paragraphs, Panelizer and Edgy, site builders can create powerful edge-to-edge landing pages. Bootstrap is not a requirement and any theme can be used, however, just make sure you have a container class which centers content.

Answer 4

I believe that theming paragraphs-item does not work as the theming function for a paragraph_item is never actually called:

Paragraphs includes a theme template declaration for paragraphs-item, however the ParagraphItemEntity class never uses this, instead it passes the rendering to EntityAPIController, which uses #theme = 'entity'.

This is probably acceptable, but the theme declaration should be removed if that is the case.

from bug in paragraphs module: Paragraphs never calls #theme paragraph_item