Task description: Document the asset module and its different components. Download the newest dev version and create a documentation page in the drupal.org handbooks for each component:

  • Basic assets: integration with textarea's, showcase the asset wizard
  • WYSIWYG assets: integration with TinyMCE
  • CCK assets: single and multiple value cck field
  • Asset Bonus: installation of the module with the external zip. Showcase .swf, .flv and .mp3
  • Asset YouTube: enter your YouTube developer's ID and embed one of your YouTube movies
  • Asset Embed: enter the object code of a YouTube movie, or any other provider, and see how it embeds
  • Asset Import: put a bunch of files of different types somewhere on your installation, point the asset_import module's settings to it, and import them
  • Asset Panels: Create a node with a cck multiple-value field an attach 10 assets. Create a panels, attach this node as an asset gallery and show 4 assets per page. Then document how a block is automatically created as a preview
  • Views integration: Create a views which selects some nodes that have assets attached and display them

Each handbook page should contain a detailed explanation of how the section is set up (for instance by enabling a module), how it is configured and a step-by-step example of how to get it actually workin (by creating a node, a panels or a views for instance). Include pictures on the configuration and the example and a screenshot of how it eventually looks.

Resources:

Primary contact: Wim Mostrey

CommentFileSizeAuthor
#15 asset-images.zip179.1 KBphilipw

Comments

aclight’s picture

Status: Needs review » Needs work

1. I suspect that you don't want the student to go through detailed steps of how to enable modules on each handbook page, but if that's the case I don't think it's crystal clear, and I would hate for a student to waste his time doing that 9 times at the beginning of the task.

2. I would point them to the location of the parent page in the handbook under which you wish the pages the student generates to go, so that somebody doesn't have to go back later and change the parents for a bunch of pages.

3. There is no deliverables section. It's pretty obvious from the description section, but the deliverables section allows us GHOP admins to quickly scan an issue and see what it is that the student needs to do so we can quickly check to see if the student is making appropriate progress.

The above comments are all pretty minor, so once you've addressed them feel free to add this as a task.

wmostrey’s picture

Component: Task idea » GHOP Task
Status: Needs work » Active

Thanks for your input. The task has been created: GHOP task #117.

You can make this node the DrupalIssue for the task.

aclight’s picture

Title: GHOP: Document the asset module » GHOP #117: Document the asset module
webchick’s picture

Project: Google Highly Open Participation Contest (GHOP) » Asset
Version: » 5.x-1.x-dev
Component: GHOP Task » Documentation

Let's stick this in the Asset module queue.

philipw’s picture

I'm having issues integrating assets with tinymce. One of the few places I found it explained was here: http://drupal.org/node/149582, when I added the code listed (took away the php opening and closing tags, wouldn't of made sense in the plugin_reg.php) it added a drupalassest check box in the tinymce buttons section, but when checked it doesn't do anything. I also found this article: http://drupal.org/node/204622, which said to move the tinymce files from the assest folder to the tinymce's plugins folder, but that didn't do anything either. So I'm not quite sure what to do.

wmostrey’s picture

Philipw, you're posting this on a GHOP Documentation task. There article you're mentioning (http://drupal.org/node/204622) is in fact the issue report where you should post this.

Also note that there are two plugin folders for tinymce: tinymce/plugins and tinymce/tinymce/jscripts/tiny_mce/plugins/. You should copy it to the second directory.

If you need more help on this, please post it in the correct issue.

aclight’s picture

@wmostrey: I don't quite understand your comment above. philipw is the student (I think) who has claimed this GHOP task, so shouldn't he be posting here if he is having problems with the task?

wmostrey’s picture

Ah my bad, I didn't see it was Philip that claimed it, sorry about that. Thanks for doing this Philip, it is highly appreciated!

The first thing I can come up with is that TinyMCE has 2 plugin directories, of which only one should be used for 3rd party integration (like this one): instead of using tinymce/plugins, try tinymce/tinymce/jscripts/tiny_mce/plugins/.

Let me know if this doesn't solve your issue.

philipw’s picture

Tried moving the drupal asset folder, didn't work. The only thing it changed was I got 2 javascript errors, before I moved it from the first plugin directory I only got one. These are the errors I'm getting:

tinyMCE.importPluginLanguagePack is not a function
from file '/sites/all/modules/tinymce/tinymce/jscripts/tiny_mce/plugins/drupalasset/editor_plugin.js'

tinyMCE.getEditorId is not a function
from file '/sites/all/modules/asset/tinymce/asset_tinymce_helper.js'

wmostrey’s picture

So you have the following:

  1. A tinymce/tinymce/jscripts/tiny_mce/plugins/drupalasset directory
  2. You updated tinymce/plugin_reg.php with the following code (at the end of the file, before "return $plugins;"):
    $plugins['drupalasset'] = array();
    $plugins['drupalasset']['theme_advanced_buttons1'] = array('drupalasset');
    $plugins['drupalasset']['extended_valid_elements'] = array('img[class|src|border=0|alt|title|width|height|align|name]');
    

Correct?

philipw’s picture

That is exactly correct.

Also what exactly is supposed to be the parent when I write the handbook pages? Is the last 9 supposed to have the first one as their parent? I see there is already an 'asset' handbook page, but I guess I'm supposed to create a new one since that one belongs to the asset maintainer.

wmostrey’s picture

That page is just a placeholder. You can create a new one and I'll replace the placeholder and the link on the asset project once all documentation is done. This page is the parent and all other pages are children of this one parent.

I'd suggest you continue the documentation on the other segments and I'll continue looking why you're running into this bug.

wmostrey’s picture

It's really odd the TinyMCE plug-in doesn't work for you. I got confirmation at http://drupal.org/node/204622 that those simple 2 steps are really all that's needed to get it working. Did you try clearing cache for instance?

philipw’s picture

Thanks for the help, I'll try just doing a drupal reinstall and start from scratch and see if that works.

philipw’s picture

StatusFileSize
new179.1 KB

I added the first page: http://drupal.org/node/208258
I have some screen shots that I think would be helpful can I put them in or does someone else have to do it for me. They are attached.

wmostrey’s picture

The images look great. Perhaps you could save them in a slightly higher resolution or as .png's. You could also try putting a red circle around the area of importance, especially on the configuration pages because it is not always clear what the important bits are.

aclight’s picture

@philipw: It would probably be easiest for you if you apply to be a documentation maintainer (if you aren't already) by creating such an issue at http://drupal.org/project/issues/documentation. Make sure to include your drupal user id (the number, not the name). Once you have documentation maintainer status, you can upload images to handbook pages and use <img></img> tags within handbook pages by changing the input format of the node to Documentation.

philipw’s picture

I still can't get tinymce plugin working. I tried a fresh installation, even on a different machine and it still didn't work, so I don't know. What do you think about my new pages:

http://drupal.org/node/209387
http://drupal.org/node/209404

philipw’s picture

wmostrey’s picture

Hey Philip, this is perfect! The screenshots look really great as well, this is exactly what I had in mind. Could you tell me what you do on a fresh install to get asset integration?

philipw’s picture

First I install drupal. Then I install the asset module and the tinymce module. I move those files from the asset folder to the tinymce folder, and also add the lines of code to the plugin_reg.php. Then I go and activate the modules on the Administer>Site building>Modules page. Then I configure Tinymce and select the asset button in its button options. Then I go to create some content and the tinymce bar shows up but not the asset button. Since others say this work I think I might just do up a handbook page as best I can.

P.S. I can't get the asset embed module or the asset youtube module to work either.

philipw’s picture

I was trying to do panels integration and I ended up with this error after creating a new panel as specified:

    * warning: Invalid argument supplied for foreach() in W:\www\drupal ghop\modules\node\node.module on line 521.
    * warning: implode() [function.implode]: Bad arguments. in W:\www\drupal ghop\modules\node\node.module on line 525.
    * user warning: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near '' at line 1 query: SELECT n.nid, n.vid, n.type, n.status, n.created, n.changed, n.comment, n.promote, n.sticky, r.timestamp AS revision_timestamp, r.title, r.body, r.teaser, r.log, r.format, u.uid, u.name, u.picture, u.data FROM node n INNER JOIN users u ON u.uid = n.uid INNER JOIN node_revisions r ON r.vid = n.vid WHERE in W:\www\drupal ghop\includes\database.mysql.inc on line 172.

and when I try to bring up the view:

Fatal error: Call to undefined function i18n_get_lang() in W:\www\drupal ghop\sites\all\modules\asset\asset_panels.module on line 21

wmostrey’s picture

Thanks for bringing this up Philip, I'm fixing the asset_panels error asap.
About the warnings: did you put a correct node id or title in the asset field for the panel, using the autocomplete function?

yched’s picture

philipw : is your drupal install in a subfolder of your webroot ?
Maybe your difficulties could be related : http://drupal.org/node/207976

philipw’s picture

@wmostrey: yes I used the autocomplete function, so I know it was right

@yched: no it's not in the root so I'll try the patch or try moving it to the root, thanks

aclight’s picture

Status: Active » Needs review

philipw has indicated that he has finished all of the pages in the ghop task tracker, so I'll set the status as CNR here.

jmlane’s picture

Not sure if this is the place to comment, but it is related to the Asset documentation.

The page relating to CCK Assets (http://drupal.org/node/209387) doesn't explain how to get the "Download this audio file" link to appear on a node with an asset field. It isn't clear if these links are part of the module, generated automatically for certain file formats, or if they are manual, such as when you pick between embedding an image or just providing a link to it.

wmostrey’s picture

Status: Needs review » Fixed

I'm marking this GHOP task as fixed, thanks a lot for your great work Philip!

Jonathan, the link is automatic. If you are experiencing further issues on this, you can open a new issue for it.

Anonymous’s picture

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for two weeks with no activity.