Documentation

Help people help Drupal: link to 'how to apply a patch' from issues with patches on d.o

Key words and phrases: 
link to patch documentation how to apply a patch An aside on patching patch application
Description & Info: 

I will try to make sure that part of the Drupal.org redesign or before is to add a link to the "apply a patch" documentation from issues with patches.

by Benjamin Melançon
Posted on Sat, 2008-03-15 20:04
in

Draft documentation for Nodequeue 2

Description & Info: 

Current Readme: http://www.logrus.com/nodequeue/readme.txt
Further resources: http://www.angrydonuts.com/why_node_queue_is_an_important_m
Tutorial (June 7) - http://www.drupal.org.uk/node/255

Earl Miles outline of needed documentation:

The starting point is the readme. The documentation needs to describe the following things:

Basic use of Nodequeue

A nodequeue can be used to feature an arbitrary set of nodes, for instance with a random view with a limit of one in a block, and furthermore have a set order and limit, such as to list "My current top 5 favorite nodes."

How to create a Nodequeue

What is a Smartqueue

How to create a Smartqueue

How to use Nodequeue with Views

How to use Nodequeue with Actions

How to write Smartqueue plugins

How to use Nodequeue with other modules: the Nodequeue API

by Benjamin Melançon
Posted on Sun, 2007-10-14 10:18
in

Helping Agaric debug site availability or network issues for a site

Description & Info: 

Debugging site availability issues to a MS Windows computer.

Click on Start, Run, and then type cmd and enter.

On the command prompt opened:

  • type ping www.example.com (press enter)
  • type tracert www.example.com (press enter)
  • type telnet www.example.com 80 (press enter)
by Benjamin Melançon
Posted on Sun, 2007-10-07 09:17
in

User could not connect to database in making a site with a there-then-missing installation profile

Description & Info: 

OK, you're not likely to run into this problem.

However, if you do things the Agaric way, and point a domain at a server, and Apache sends it to a valid Drupal installation with a custom installation profile option, and you select that installation profile, and then realize you really want Apache pointing your domain to a different, 5.2 installation.

Ask Agaric: Getting started with Drupal

I have a quick question for you. I have started to play with Drupal as CMS, with plug-ins and themes etc. . . Is there a good resource out there to learn the ropes? Nothing too involved, something like Drupal for Dummies (or for Smart People).

In truth, nothing great-- the documentation is being reworked and that should help.

What's there now is OK: http://drupal.org/handbooks

Here's the improved documentation work-in-progress, already pretty good:
http://drupal.org/files/getting-started.pdf

by Benjamin Melançon
Posted on Sun, 2007-09-16 11:25
in

Taxonomy image with Category.module (Drupal 4.7)

Using taxonomy_image with category module (Drupal 4.7)

This works, but you need to know the direct path to the taxonomy image administration page (not its settings page).

The taxonomy help page - admin/help/taxonomy_image - says to do configuration at 'administer >> categories >> images'

If the Category module is installed, taking over the core taxonomy module's functions, there will be no link to image or images anything in the menu or as a tab.

Instead, you can navigate directly to the taxonomy_image admin page here:

/admin/taxonomy/image

by Benjamin Melançon
Posted on Sun, 2007-09-16 10:47
in

Ask Agaric: Views of comments in Drupal 5

how do I make a view that displays only recent comments made on a certain content type?

This is basic views functionality.

Simply filter by node: type to restrict the view to specific content types.

The trick is you have to choose list (or table and possibly other views made possible by the Views Bonus Pack). Then you can select which fields to show: comment subject and time and body and anything else comment related.

by Benjamin Melançon
Posted on Sun, 2007-09-16 09:58
in

Ask Agaric: Page not publishing

> I just added a member but it says that it is not public:
> http://example.com/member-organization/council-canadians
>
> please make it public and give me back authorization to publish.

I'll be providing way more detail than necessary in an educational, about Drupal manner...

For this problem simply, when editing the page or creating it in the first place, click on publishing options (right above the Preview/Submit buttons) and select Published, and submit.

by Benjamin Melançon
Posted on Tue, 2007-09-11 10:53
in

Ask Agaric: Unable to edit a page

> I also can't edit this page:
> http://example.com/but-i-can-see-revisions

three users all created 11 weeks 11 hours ago had the role of "submin" -- here they are and their last access.

Not-Agaric Member 3 weeks 4 days ago
Alsonot Agaric 6 weeks 3 days ago
Stillnot Ourfault 11 weeks 11 hours ago

We probably weren't clear enough at all, but submin (borrowing from the modesty, falsely or not, of Subcomandante Marcos) is the user we grant all powers to-- just blindly checking off every box, because that makes it easier for us.

by Benjamin Melançon
Posted on Tue, 2007-09-11 10:26
in

Switch is for equality comparison only, not for greater than / less than

No less than or greater than statements allowed in switch statements?

Apparently not.

comparison operator in switch statement

WRONG! - this syntax caused a parse error

  switch ($value) {
    case '<20':
      return 1;
    case <100:
      return 5;
    case <200;
      return 10;
    case <500;
      return 20;
    case <2000;
      return 50;     
    default:
      return 100;
  }

Again, the above is BAD. It causes this:

by Benjamin Melançon
Posted on Sun, 2007-09-09 21:53
in