USAGE.txt in Prepopulate 5

See README.txt for a description of this module.
See this documentation online at http://drupal.org/node/228167.

USING PREPOPULATE MODULE
========================

Simple Usage
------------

Prepopulate the title field on a node creation form:
  http://www.example.com/node/add/content?edit[title]=This is the title
With 'non-clean' urls:
  http://www.example.com?q=node/add/content&edit[title]=This is the title


How to find what variable to set
--------------------------------

This can be tricky, but there are a few things to keep in mind that
should help.

Prepopulate.module is quite simple. It looks through the form, looking
for a variable that matches the name given on the URL, and puts the
value in when it finds a match. Drupal keeps HTML form entities in an
edit[] array structure. All your variables will be contained within the
edit[] array.

A good starting point is to look at the HTML code of a rendered Drupal
form. Once you find the appropriate  (or ...
tag, use the value of the name attribute in your URL, contained in the
edit array. For example, if the  tag looks like this:

  
  size="60" name="title" maxlength="128"/>

then try this URL:

  http://www.example.com/node/add/content?edit[title]=Automatic filled in title

CCK fields are a bit more complicated:

  
  name="field_office[0][node_name]" maxlength="128" autocomplete="OFF"/>

The key is to put this in the edit[] array nested, like this:

  http://www.example.com/node/add/content?edit[field_office][0][node_name]=AL-235

Another example:

  <li>  cols="60"/>
</li><li>
</li><li>would be:
</li><li>
</li><li>  http://www.example.com/node/add/content?edit[field_content][0][value]=A long text string
</li><li>
</li><li>and, again, for non-clean URLs, it's:
</li><li>
</li><li>  http://www.example.com?q=node/add/content&edit[field_content][0][value]=A long text string
</li><li>
</li><li>
</li><li>Body fields
</li><li>-----------
</li><li>
</li><li>Body fields are different. Though their HTML entity looks like this:
</li><li>  <textarea id="edit-body" class="form-textarea resizable processed"
</li><li>  name="body" rows="20" cols="60"/>
</li><li>
</li><li>You can't just take the name "body," throw it into a edit[body] and
</li><li>expect it to work. Drupal wraps the body field into a "body_filter"
</li><li>array when it gets processed. So, for body fields, a URL like:
</li><li>
</li><li>  http://www.example.com/node/add/content?edit[body_filter][body]=This is the body
</li><li>
</li><li>ought to do the trick.
</li><li>
</li><li>
</li><li>Multiple fields
</li><li>---------------
</li><li>
</li><li>Prepopulate can handle pre-filling multiple fields from one URL. Just
</li><li>separate the edit variables with an ampersand:
</li><li>
</li><li>  http://www.example.com/node/add/content?edit[title]=The title&edit[body_filter][body]=The body
</li><li>
</li><li>You're already using the ampersand with non-clean URLs:
</li><li>
</li><li>  http://www.example.com?q=node/add/content&edit[title]=The title&edit[body_filter][body]=The body
</li><li>
</li><li>
</li><li>Escaping special characters
</li><li>---------------------------
</li><li>
</li><li>Some characters can't be put into URLs. Spaces, for example, work
</li><li>mostly, but occasionally they'll have to be replaced with the string %20.
</li><li>This is known as "percent encoding." Wikipedia has a partial list of
</li><li>percent codes at:
</li><li>  http://en.wikipedia.org/wiki/Percent-encoding
</li><li>
</li><li>If you're having trouble getting content into field names, or are
</li><li>getting 'page not found' errors from Drupal, you should check to ensure
</li><li>that illegal characters are properly encoded.
</li><li>
</li><li>
</li><li>Bookmarklets
</li><li>------------
</li><li>
</li><li>Prepopulate.module was created for bookmarklets. Here is the actual
</li><li>bookmarklet I use to post web links to my site:
</li><li>
</li><li>javascript:u=document.location.href;t=document.title;s=window.getSelection();void(window.open(%22http://oif.eafarris.com/node/add/content-web-link?edit[title]=%22+escape(t)+'&edit[body_filter][body]='+escape(s)+'&edit[field_url][0][value]='+escape(u),'_blank','width=1024,height=500,status=yes,resizable=yes,scrollbars=yes'));
</li><li>
</li><li>This turns into a URL like this:
</li><li>
</li><li>http://oif.eafarris.com/node/add/content-web-link?edit[title]=drupal.org%20%7C%20Community%20plumbing&edit[body_filter][body]=&edit[field_url][0][value]=http%3A//drupal.org/
</li><li>
</li><li>If I had first selected some text on the page, it would be put into the
</li><li>body of the node.
</li><li>
</li><li>Happy prepopulating!
</li></ol></code></pre></details>


<div class="api-objects">
</div>
      
    </div></div> <!-- /.section, /#content -->

        
          <div id="sidebar-second" class="column sidebar"><div class="section">
          <div class="region region-sidebar-second">
    <div id="block-api-navigation" class="block block-api">

    <h2>API Navigation</h2>
  
  <div class="content">
    <div class="item-list"><ul><li class="first"><a href="/api/prepopulate/5">Prepopulate 5</a></li>
<li><a href="/api/prepopulate/functions/5">Functions</a></li>
<li class="last"><a href="/api/prepopulate/files/5">Files</a></li>
</ul></div>  </div>
</div>
  </div>
      </div></div> <!-- /.section, /#sidebar-second -->
    
  </div></div> <!-- /#main, /#main-wrapper -->

  
  <div id="footer-wrapper"><div class="section">

    
          <footer id="footer" role="contentinfo" class="clearfix">
          <div class="region region-footer">
    <div id="block-block-1" class="block block-block">

    
  <div class="content">
    <p><footer>Drupal is a registered trademark of Dries Buytaert. This site is not affiliated with Dries Buytaert, Drupal Association or Drupal.org.</footer></p>
  </div>
</div>
  </div>
      </footer> <!-- /#footer -->
    
  </div></div> <!-- /.section, /#footer-wrapper -->

</div></div> <!-- /#page, /#page-wrapper -->
  </body>
</html>

<!-- Page cached by Boost @ 2022-08-23 23:56:35, expires @ 2023-08-22 23:56:35, lifetime 12 months 4 days -->