Fullscreen
   

Search Wiki PageName

Exact match

Quick Edit a Wiki Page

Menu

Forum: Catapult Message Board

Forums > Catapult Message Board > The Ballistic Coefficient of Pumpkins

The Ballistic Coefficient of Pumpkins


2 stars
A trebuchet is a type of catapult that converts the potential energy of a counterweight into the kinetic energy of a projectile. The simplest version operates like a see-saw, with the counterweight suspended from a hanger attached to the short arm and the projectile held in a sling attached to the throwing arm. When the short arm is raised and then released, the throwing arm rotates faster because it is longer and the sling rotates even faster as it whips around the end of the throwing arm.

At their inception during the Middle Ages, trebuchets were used to hurl boulders at castle walls in an attempt, usually successful, to batter them down. Modern trebuchet designers, lacking castles to besiege and fair maidens to rescue, must content themselves with hurling cooking pumpkins for distance. Competition, however, is fierce, and the winner of the contest can expect any fair maidens present at the pumpkin festival to hurl themselves at him. Thus, it behooves us to put as much study into the ballistics of pumpkins as old-time mathematicians put into the study of cannonballs.

From wind tunnel tests we know that the coefficient of drag, CD, of a pumpkin-sized cannonball is 0.2. This is not bad, as smaller spheres, such as musket shot, have a CD of 0.45 due to the fact that their Reynolds number is below the critical point where the air flow in the boundary layer changes from a smooth motion to a turbulent one. Somewhat counter-intuitively, a turbulent boundary layer carries more energy and is thus able to remain in contact with the surface a bit longer. This narrows the wake and increases the pressure behind the sphere. The reduction in form resistance more than compensates for the increase in viscous resistance, so there is a net reduction in drag.

Visit The Ballistic Coefficient of Pumpkins (external link) to read the rest of the paper.


Thomas 5 stars
Well, Victor the Terrible, you spent a fair amount of verbiage "immortalizing" the BAT video. I have to challenge your conclusion, though.

You state:

"It is possible that people are not analyzing their own videos. Or, possibly, the fact that their projectiles are released well over their heads gives them the illusion that their projectile’s altitude is due to a steep angle rather than to initial height. But, whatever the cause of the problem, designers need to put more work into tuning their trebs to launch at 45° before committing their inventions to YouTube."

The introductory paragraph to the video reads:

"An experiment in improving trebuchet performance by increasing the dropping distance of the counterweight. This is a rough prototype made from bits and pieces of wood that was on hand and is in a state of development.. A number of issues still need to be dealt with, but it works pretty well."


The stuff actually on ballistic properties of pumpkins is OK, if pretty basic. However, the suggestion that a pumpkin be filled with water for added density would be against the rules as set down by WCPC. Most other events follow the WCPC rules.

"8. Pumpkins are not to be altered in any way, excluding P.C.A. marker paints. All pumpkins must be in their natural state.
Pumpkins fired from machine during competition will be measured from the front of or the farthest point of machine. Your pit #
may be written on your pumpkin to help in the identification at the landing zone."



Walker 4 stars United States
Grozny,

Please stop.
You know not whereof you speak and it's embarrassing.

Walker


2 stars
> Grozny,
>
> Please stop.
> You know not whereof you speak and it's embarrassing.
>
> Walker

>
> I have seen a pumpkin fired at a depressed angle (below horizon) which climed to a 15*< ascent and continued for about 2,000 feet.
>
> Walker

You say that you saw this with your very own eyes and I believe you.

But I have to ask: Are you sure that you weren't observing the flight of a UFO?

Perhaps a little orange UFU happened to fly by at the very moment that your sling broke and left your pumpkin sitting in the grass six inches in front of your foot?

Because what you describe is really not how projectiles behave here on Earth.


madmattd 3 stars United States
> > Grozny,
> >
> > Please stop.
> > You know not whereof you speak and it's embarrassing.
> >
> > Walker
>
> >
> > I have seen a pumpkin fired at a depressed angle (below horizon) which climed to a 15*< ascent and continued for about 2,000 feet.
> >
> > Walker
>
> You say that you saw this with your very own eyes and I believe you.
>
> But I have to ask: Are you sure that you weren't observing the flight of a UFO?
>
> Perhaps a little orange UFU happened to fly by at the very moment that your sling broke and left your pumpkin sitting in the grass six inches in front of your foot?
>
> Because what you describe is really not how projectiles behave here on Earth.

Um, if he is talking about what I think he is, I was there with Walker. 2007, Bridgeville, DE. Chucky did this. Pretty much flat trajectory that climbed forever. I couldn't believe what I saw, but there you go. MASSIVE Magnus Effect. It is possible, and I have the engineering background to understand it, but it is all very emperical, tough to explain and write down into something applicable for a given geometry and other conditions.

Matt

Matt



3 stars Belgium
flying pumpkins are weard things, i'll give some examples:

a pumpkin fired started to turn sideway's, ending up making an 90° turn ito the wind...

a pumkin fired allmost horizontal started to climb and then dropped like a wounded bird...

the turning sideway's happened often to us, some went left, some went right, with same wind conditions, it all depends on projectile shape, center of gravity and the ammount of spin the sling gave...

there is no way to predict the way it will behave after release, that's the reason why i like hurling a lot, you never know what's gonne happen



Walker 4 stars United States
If a Base Ball, thrown at 80 MPH can perform a drop or lift or curve by reason of imparted spin (and the position of the stitches),
Then is it so hard to accept that a pumpkin may also have sufficent spin imparted to it at 120+ MPH whith which to cause positive lift?

UFO photo attached.

Really, Groz', I take it you were trying to disfuze the tension rather than trying to be a jerk with the UFO comment.

If you want UFOs, please visit my website: Evil Genius Labs (external link)
Your computer will be scanned and if no government spyware is found, we will open upon your hello.
However, if your computer is found to contain any form of government spyware, you will be ignored.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Edit: add on 25SEP09.

Grozny (external link) asked: "It is possible that people are not analyzing their own videos (?)."

Yes, it is possible. That is why a number of us have taken to analyzing each other's works. My video library holds 40 test videos from JohnN and another 37 from Thomas. And others, too.
I edit and reproduce these into slo-mo, super slo-mo, super-duper schlow-mo, etc.
I consider that a fair question.



trebdude 3 stars United States
Chuck's last throw at WCPC climbed for about 2-3 seconds after launch, then set a new record. Pumpkins are imperfect and behave weirdly.
Tom



Thomas 5 stars
Seems like it's Bash Grozny Time. Why? Well, we have someone from Academia telling people who have real-world knowledge of a subject "how it is".

The article in question is basically fluff. Other than data taken from one pumpkin, statistically an invalid sampling, and the previously discussed video insertion, not particularly germane, it's unattributed cribbed data (unless Grozny did the wind tunnel tests himself, in which case I apologize).

Missing data include what variety of pumpkin was tested, of the many available. Some are more suitable for hurling than others, a fact well known to hurlers, apparently not to others.

Among the missing was any evidence that the ballistics of spinning objects was looked into. There is a large amount of research on that subject, much of it by the manufacturers of golf balls. Spin is an important factor in the flight of many objects. "Bend it like Beckham", hooking or slicing a golf ball, a popup in baseball.

Proceeding from that, the effect of the shape of various pumpkins needed to be tested. Does a ribbed one fly better than a smooth one? Dimpled golf balls do better than smooth ones, as is well known. Some pumpkins are flatter than others. Will a flat one thrown edge-on do as well as a round one? With a round pumpkin, is the orientation of the stem important?

When the paper sticks to its subject it's correct, if overly-limited in its treatment of that subject. Unfortunately it strays into other areas and reaches conclusions that are questionable.


2 stars
> Seems like it's Bash Grozny Time. Why?

Why? Probably because I refuted your theory that 45° is only optimal in a vacuum. Duh!

I added the following paragraphs to my paper just for you:

In the first draft of this paper, I wrote that everybody knows that the optimal launch angle is 45°. I assumed that deviations from this ideal were inadvertent. However, after joining the Catmess (Catapult Message Board), I found that the majority of hurlers, or at least the most vocal ones, earnestly believe that 45° is only optimal in a vacuum. For example, one guy, who has constructed a trebuchet that launches at 24°, writes:

"Trig is something I never used and forgot around 1962. When working with trebs you need to divorce yourself from pure mathematics. The real world is very different.

"Galileo proposed the 45° launch angle, and he was a bright guy, but he didn't know everything. Don't be too much in love with pure mathematics. The 45° thing may be valid for a parabolic flight path, but missiles don't follow parabolas except at low speeds and/or with high ballistic coefficients.

"I've seen a claim that 31° was the optimum launch angle, and the claimant had math to back it up. You know what they say about figures don't lie.''

While these guys are a little fuzzy on their rationale for a smaller angle, it is possible that they have heard that one needs to fire low when faced with a stiff headwind and they thought that the “wind” created by the pumpkin’s motion through still air also necessitates a low shot.

The reason that one fires low into a headwind is that wind is horizontal. While the pumpkin is ascending, the wind pushes it back, steepening its angle of ascent and thus necessitating starting out with a smaller initial angle. But the “wind” created by movement is not horizontal; it pushes in exactly the opposite direction of motion, whichever way that might be. Thus, it does not affect the pumpkin’s angle; it just slows the pumpkin down.



2 stars
Thanks to you guy's highly accurate and unimpeachable eyewitness accounts, I have able to add the following paragraphs to my paper:

I see no evidence that the opening of a nylon pouch imparts spin to pumpkins. Balls are given spin when they roll; for example, a baseball rolls off the pitcher’s fingertips or a golf ball rolls up the angled face of a club. A golf ball is violently struck by a steeply angled clubface made of unyielding steel and with very aggressive grooves cut into it to gain traction and assure that the ball rolls rather than slides up the face. It accelerates from a standstill up to speeds over 60 m/s in less than 10 ms, which is a very different thing than a pumpkin gently nestled in a smooth nylon pouch and taking about 50 to 60 times longer to accelerate up to speed, at which point the pouch just opens, without any twisting motions. Anyway, pumpkins lack the raised stitches or dimples that cause baseballs or golf balls to curve.

There is a group of guys at the Catmess who seem to think that the phrase “Magnus effect” is a sort of magical incantation that, when spoken, will dispel any doubts about the most outlandish braggadocio. These guys are probably amateur golfers who learned this big and very scientific-sounding word from their golf pro. Observing the rather unpredictable trajectories of their own golf balls at the driving range, they concluded that ballistics has a sort of anything-goes quality that is ideally suited to internet bragging.

For example, one fellow writes, “I have seen a pumpkin fired at a depressed angle (below the horizon) which climbed to a 15° ascent and continued for about 2,000 feet.” When asked for an explanation of this gravity-defying feat, he replies, “Is it so hard to accept that a pumpkin may have sufficient spin imparted to it at 120+ mph with which to cause positive lift?”

Obviously, there is not much that I can do to help this gentleman. But, for those of you launching pumpkins at angles between zero and ninety degrees and with sling pouches that somehow manage to open without spinning the poor pumpkin up to hundreds of rpm, my software will help you create a ballistics table for your trebuchet.

Also, while I hesitate to impugn the craftsmanship that goes into these homemade devices, I must raise the possibility that they wobble. Perhaps sometimes their frames flex to the left and sometimes to the right. The resulting trajectories, being reminiscent of the hook or slice of a golf ball, conjured up talk of the Magnus effect, rather than a tightening of wood screws, which might have actually helped.

A wobbly treb is probably the explanation for this guy’s observations:

"Turning sideways happened often to us; some went left, some went right, with same wind conditions. It all depends on projectile shape, center of gravity and the amount of spin the sling gives. There is no way to predict the way it will behave after release. That's the reason why I like hurling a lot. You never know what is gonna happen."

Frankly, I do not think I would want to stand too close to this guy’s treb during a pumpkin launch. You never know what is gonna happen!


admin 3 stars
Hey Grozny,

are you sure you've never been here before? You're starting to sound an awful lot like a guy we used to know named David Ratliff.

Here, try this on for size: "In theory, there is no difference between theory and practice. In practice, however, there is." That's because the world is a much bigger place than our little brains are, and we just can't fit all the variables, permutations, eventualities and complex interactions in them. Knowledge without wisdom can be dangerous.

You need to put your ego aside and get an education. Go talk to any let me repeat that last word... ANY college freshman level engineering physics professor. Ask him about ballistic motion and optimal trajectories in an atmosphere, and you'll find out that it greatly depends on the spin, drag coefficient and velocity of the projectile. Go to any - once again, ANY - hurling competition and watch the pumpkins spin like crazy out of the pouch. Listen to the whistle of the bowling balls, and tell me that thing ain't spinning. I dare you.

The velocity of the projectile changes as it flies. It's DE-celerating due to the friction of the air. That means that the interaction between the vertical and horizontal components of the trajectory interact differently at the beginning than at the end, and you need a lower angle to get the most distance. That 45 degree nonsense only works in a vacuum because the horizontal component must remain constant (no drag) for it to work out that way.

Oh, also, if you post another one of your self-promoting inflammatory spam-like posts to my web site, I'll ban you. Please stay, we like intelligent and lively discourse, but please put the ego aside. We know you mother believes in you, but out here, you've got a lot to learn. You've been warned.

-- Ron


2 stars
> Hey Grozny,
>
> are you sure you've never been here before? You're starting to sound an awful lot like a guy we used to know named David Ratliff.
>

I am not David Ratliff and I don't know him.


SpringTreb 3 stars United States
The further the attachment point of the sling is from the release pin/ring, the more spin is imparted on the projectile. As the sling and projectile rotate around the TA tip, the pouch rolls the projectile like a baseball pitcher fingers do on a baseball.

Craig


> I see no evidence that the opening of a nylon pouch imparts spin to pumpkins.



trebdude 3 stars United States
You are more than welcome to come to Delaware and meet some of the fine people that have no idea what they are talking about. Of course it would be easier to sit behind a computer and criticize those that have actually constructed something besides a "paper" and some sarcastic comments.



Walker 4 stars United States
Groz',
Tact isn't your forte, is it.

If you have some credentials, please share.
It may make it easier to accept some guy who apparently walks in off the street and starts spouting off about how we are all wrong even though his head is so far up his inseam that his eyes have turned brown.

My creds? None you would recognize until one hit you.

Your "Paper"?
I found that the selected quotations of my fellows here tended to elevate the quality of the work.
I am quoted accurately if not attributed. (Nor do I consent to being quoted outside of this forum.)

This “gentleman” (hack, hack) did not ask for your misguided help. Furthermore I find it insulting to be labeled as such.
Fact is, Groz’, I am not a gentleman at all. I’m one of those guys who volunteered to fight so that your right to express yourself would be protected. That being said, I really hope you will find another forum in which to express yourself.

Walker



madmattd 3 stars United States
How about a 5th year Mechanical Engineer who has some Fluid Dymanics under his belt? The Magnus Effect is REAL, I have personally observed its effects with trebuchets, caused it to occur even more by adjusting the fixed position of the sling, and can even give you some rough idea of its effects on a pumpkin (way too long to go into right now, and it's late). And the 45 degree trajectory, as ANY Physics Teacher who knows what they are talking about will tell you, applies only in a vaccuum. In fact, most state that when they introduce the "optimum" trajectory as 45 degrees, mine sure did. Again, it has to do with some Fluid Mechanics/Dynamics. Please, I do not want to sound like I am attacking you, but I cannot stand people standing behind a desk/computer telling people who have real-world experience what is real and what isn't. Theory is great, but you need practical hands-on experience to back it up and to make yourself credible. I know far too many people from my time in college that do not understand that the real world does not work according to their equations.

Matt



Walker 4 stars United States
When theory and practice colide, which is the first to go?
Groz' does not understand Zen Trebuchet.
Therefore all he has is what he remembers from his classes.

GROZNY (external link)

Walker



BobP 3 stars United States
This got posted last week on another board I frequent. Here's a link (external link).

Conclusions are generally similar to here. You can probably guess which member I am over there...


thomas 5 stars
> This got posted last week on another board I frequent. Here's a link (external link).
>
> Conclusions are generally similar to here. You can probably guess which member I am over there...

Bob, thanks for bringing that to our attention. Maybe I'm a little too close to the situation, but Grozny/Shaka chose to misrepresent data regarding the video cited (mine) and refused to change that misrepresentation in his paper when I called him on it. The dude lacks intellectual honesty.

He got well and truly spanked on the other forum, and while it may be uncharitable for me to be glad, I am. I see that he hadn't made a follow-up to his original post. Didn't get his desired response so he's all in a snit, I guess.



trebdude 3 stars United States
That one guy basically went line by line disproving his paper. Remind me never to submit anything to rocket scientists! Ouch!eek


madmattd 3 stars United States
> That one guy basically went line by line disproving his paper. Remind me never to submit anything to rocket scientists! Ouch!eek

I was glad to see he did that. No spin on pumpkins, no way. Should've seen our last test shot Sunday, you wanna talk about spin...

Matt


BobP 3 stars United States
> That one guy basically went line by line disproving his paper. Remind me never to submit anything to rocket scientists! Ouch!eek

The BAUT forum is pretty frequently visited by folks who believe the moon landings were faked and other even wackier stuff. The members are pretty used to using facts to destroy speculation. Ron Toms has even posted a message now, but nothing more from Shaka/Grozny in either location.


Walker 4 stars United States
> That one guy basically went line by line disproving his paper. Remind me never to submit anything to rocket scientists! Ouch!eek

A scientific paper deserves scientific reasoning.
Mr. Grozny is unable to contribute scientifically and must resort to character assinations and misrepresentations (AKA: "Lies").

I just returned to the site  (external link) and found that Ron had been quoted:
"You need a lower angle to get the most distance. That 45° nonsense only works in a vacuum because the horizontal component must remain constant (no drag) for it to work out that way. Go talk to any — let me repeat that last word... ANY — college freshman-level engineering physics professor. I dare you."

– Ron Toms
(Administrator, Catapult Message Board)

And supposedly rebutted by a quote from a "professor":

"It will be noticed that the maximum value of v2sin(2φ)/c for a given velocity, v, and ballistic coefficient, c, occurs when φ = 45°. This means that maximum range will be found with this angle of projection, which is not strictly true, although, in practice, variations of φ around this value produce very little effect on the range."

– Professor C. B. Daish
(The Physics of Ball Games, p. 128)

I searched for anything on "Professor" Daish but could not find where he taught or of what subject he was said to be a professor.
In spite of lacking internet bona fides, he has written a few books with over simplified explinations of the physics involved with ball related sports.
May I presume the professor does not teach AQP?

While I do not accept a quote from a professor as being the same as the professor actually responding to Ron's challange, I don't think this professor is still able to respond for himself.

Further exploation shows this quote, three quarters of the way down the page:

"The optimal angle is actually 42.5°".

No Duh, Sherlock?
Thanks for waisting all our time, Grozny.
Now just go away.

Walker


BobP 3 stars United States

> Thanks for waisting all our time, Grozny.
> Now just go away.
>
> Walker

He already has. Hasn't been back to the other forum either. But there've been some good discussions there, including visits from Ron & Ripcord.


Walker 4 stars United States
>
> > Thanks for waisting all our time, Grozny.
> > Now just go away.
> >
> > Walker
>
> He already has. Hasn't been back to the other forum either. But there've been some good discussions there, including visits from Ron & Ripcord.

Thank you Bob.

Once again, here's a link to the BAUT forum.  (external link)

Walker



SpringTreb 3 stars United States
Punkins do spin.

http://www.youtube.com/watch?v=Blftpqd4Gd4 (external link)

Craig


Thomas 5 stars
> Punkins do spin.
>
> http://www.youtube.com/watch?v=Blftpqd4Gd4 (external link)
>
> Craig

No question to any of us here that they spin. That looked like a futbol, though. I wonder if Grozny would deny that Beckham "bending it" is anything but observer error. No raised seams or dimples, ya know.

Funny how someone with zero hands-on experience can set himself up as an expert.

Thomas


SpringTreb 3 stars United States
I thought it was a pumpkin until I finally saw the end of the video. I couldn't get it to play more than halfway thru earlier.

Craig

> > Punkins do spin.
> >
> > http://www.youtube.com/watch?v=Blftpqd4Gd4 (external link)
> >
> > Craig
>
> No question to any of us here that they spin. That looked like a futbol, though. I wonder if Grozny would deny that Beckham "bending it" is anything but observer error. No raised seams or dimples, ya know.
>
> Funny how someone with zero hands-on experience can set himself up as an expert.
>
> Thomas


trebdude 3 stars United States
More than likely, it's a fitness ball. We use one for testing, weighs exactly 8 lbs, is about the right size and takes a beating without getting destroyed in the process. A good $15-$20 investment.


madmattd 3 stars United States
> More than likely, it's a fitness ball. We use one for testing, weighs exactly 8 lbs, is about the right size and takes a beating without getting destroyed in the process. A good $15-$20 investment.

Yea. We pegged our 4-pounder into a tree at about 550-600 feet, on a line drive. Bounced straight back out a good 100+ feet! And you wouldn't even know it by looking at it. Those things are great.



Walker 4 stars United States
I was hesitant to see ugly slime may have returned to this thread but I only found my hurling buds, nobody named after a Chechen city that the Russans used like a cheap ~um~ (family safe site?) ~er~ Ah!:
like a cheap plate of HUNGARIAN GOULASH!

Maybe he was abducted by alien pumpkins.
Maybe someone would think I had anything to do with his sudden disappearance. Who? Me?
I don't make goulash, I do Chili. (Non-Texas style.)

Footballs don't spin, either.


Show posts:
Jump to forum:
Wiki Syntax
Bold text     __text__
Italic text     2 single quotes (').     ''text''
Underlined text     ===text===
Colored text
~~#FFEE33:text~~ or ~~yellow:text~~. Will display using the indicated HTML color or color name. Color name can contain two colors separated by a comma. In this case, the first color would be the foreground and the second one the background.
Deleted text     2 dashes "-".     --text--
Headings
!heading1, !!heading2, !!!heading3
Show/Hide
!+, !!- show/hide heading section. + (shown) or - (hidden) by default.
Autonumbered Headings
!#, !!#, !+#, !-# ...
Table of contents
{toc}, {maketoc} prints out a table of contents for the current page based on structures (toc) or ! headings (maketoc)
Horizontal rule     ----
Text box     ^Box content^
Centered text     ::text::
Dynamic variables
%Name% Inserts an editable variable
External links
use square brackets for an external link: [URL], [URL|link_description],[URL|link_description|relation] or [URL|description|relation|nocache] (that last prevents the local Wiki from caching the linked page; relation can be used to insert rel attribute for the link - useful e.g. for shadowbox).
For an external Wiki, use ExternalWikiName:PageName or ((External Wiki Name: Page Name))
Square Brackets
Use [[foo] to show [foo].
Wiki References
((page)) or ((page|description)) for wiki references
Lists
* for bullet lists, # for numbered lists, ;Word:definition for definiton lists
Indentation
+, ++ Creates an indentation for each plus (useful in list to continue at the same level)
Tables
||row1-col1|row1-col2|row1-col3||row2-col1|row2-col2|row2-col3||
Title bar     -=Title=-
Monospace font     -+Code sample+-
Line break
%%% (very useful especially in tables)
Multi-page pages
Use ...page... to separate pages
Non parsed sections
~np~ data ~/np~ Prevents wiki parsing of the enclosed data.
Preformated sections
~pp~ data ~/pp~ Displays preformated text/code; no Wiki processing is done inside these sections (as with np), and the spacing is fixed (no word wrapping is done). ~pre~ data ~/pre~ also displayes preformatted text with fixed spacing, but wiki processing still occurs on the text.
Comments
~tc~ Tiki Comment ~/tc~ makes a Tiki comment. It will be completely removed from the display, but saved in the file for future reference. ~hc~ HTML Comment ~/hc~ makes an HTML comment. It will be inserted as a comment in the output HTML; these are not normally displayed in browsers, but can be seen using "View Source" or similar.
Block Preformatting
Indent text with any number of spaces to turn it into a monospaced block that still follows other Wiki formatting instructions. It will be indended with the same number of spaces that you used. Note that this mode does not preserve exact spacing and line breaks; use ~pp~...~/pp~ for that.
Direction
{r2l}, {l2r}, {rm}, {lm}Insert resp. right-to-left and left-to-right text direction DIV (up to end of text) and markers for langages as arabic or hebrew.
Special characters
~hs~ hard space, ~c~ ©, ~amp~ &, ~lt~ <, ~gt~ >, ~ldq~ “, ~rdq~ ”, ~lsq~ ‘, ~rsq~ ’, ~--~ —, ~bs~ \, numeric between ~ for html numeric characters entity

Because the Wiki paragraph formatting feature is off, each line will be presented as you write it. This means that if you want paragraphs to be wrapped properly, a paragraph should be all together on one line.

Plugins

Note that plugin arguments can be enclosed with double quotes ("); this allows them to contain , or = or >.


Description
Article
Includes an article's content within the page.
{article
[ Field="The article field to display. Default field is Heading." ]
[ Id="The article to display. If no value is provided, most recent article will be used." ]
}
Article List
Includes a list of articles within the page.
{articles
[ max="The amount of articles to display in the list." ]
[ topic="[!]topic+topic+topic" ]
[ topicId="[!]topicId+topicId+topicId" ]
[ type="[!]type+type+type" ]
[ categId="The ID of the category to list from." ]
[ lang="The article language to list." ]
[ sort="The column and order of the sort in columnName_asc or columnName_desc format." ]
[ quiet="Whether to not report when there are no articles." ]
[ titleonly="Whether to only show the title of the articles." ]
}
Attachment
Displays an attachment or a list of them
{ATTACH(
[ name="Gives the name of the attached file to link to" ]
[ file="Same as name" ]
[ page="Gives the name of another page the attached file is on. The file on that page is linked to instead. Only works with wiki pages" ]
[ showdesc="Shows the description as the link text instead of the file name" ]
[ bullets="Makes the list of attachments a bulleted list" ]
[ image="Says that this file is an image, and should be displayed inline using the img tag" ]
[ inline="Puts the stuff between {ATTACH} tags as the link text instead of the file name or description" ]
[ all="Shows all attachments from the whole wiki" ]
[ num="Gives the number, in the list of attachments, of the attachment to link to" ]
[ id="Gives the actual id of the attachment to link in. You probably should never use this" ]
[ dls="Puts the number of downloads in the alt comment" ]
[ icon="Shows a file icon" ]
)}
Comment
{ATTACH}
Box
Insert theme styled box on wiki page
{BOX(
[ title="Displayed above the content" ]
[ bg="As defined by CSS, name or Hex code." ]
[ width="In pixels or percentage. Default value is 100%." ]
[ align="left|right|center" ]
[ float="left|right, for box with width lesser than 100%, make text wrap around the box." ]
[ class="Apply custom CSS class to the box." ]
)}
text
{BOX}
Center
Centers the plugin content in the wiki page
{CENTER( )}
text
{CENTER}
Code
Displays a snippet of code
{CODE(
[ caption="Code snippet label." ]
[ wrap="0|1, Enable word wrapping on the code to avoid breaking the layout." ]
[ colors="Syntax highlighting to use. May not be used with line numbers. Available: php, html, sql, javascript, css, java, c, doxygen, delphi, ..." ]
[ ln="0|1, may not be used with colors." ]
[ wiki="0|1, parse wiki syntax within the code snippet." ]
[ rtl="0|1, switch the text display from left to right to right to left" ]
[ ishtml="0|1, display the content as is instead of escaping HTML special chars" ]
)}
code
{CODE}
Definition List
Creates a definition list
{DL( )}
One entry per line. Each line is in "Term: Definition" format.
{DL}
Events
Includes the list of events from a calendar in the page.
{events
calendarid="Numeric"
[ maxdays="Numeric" ]
[ max="Numeric" ]
[ datetime="0|1" ]
[ desc="0|1" ]
}
Fade
Displays a label. On click, the block of content will fade in and fade out.
{FADE(
label="Label to display on first display"
)}
Wiki syntax containing the text to display.
{FADE}
Fancy List
Creates a fancy looking list
{FANCYLIST(
[ div="Use div instead of ol" ]
[ class="CSS class of the fancylist" ]
)}
One item per line starting with anything followed by ")".
{FANCYLIST}
Fancy Table
Displays the data using the Tikiwiki odd/even table style
{FANCYTABLE(
[ head="Heading row of the table, same format as the body section." ]
[ headclass="CSS Class to apply on the heading row." ]
)}
One row per line, cells separated by ~|~.
{FANCYTABLE}
File
Displays a link to an attachment to a wiki page and can display an image attachment.
{file
name="Gives the name of the attached file to link to"
[ desc="Comment" ]
[ page="Gives the name of another page the attached file is on. The file on that page is linked to instead. Only works with wiki pages" ]
[ showdesc="Shows the description as the link text instead of the file name" ]
[ image="Says that this file is an image, and should be displayed inline using the img tag" ]
}
Files
Displays a list of files from the File Gallery
{FILES(
[ galleryId="Gallery ID" ]
[ categId="Category ID:Category ID" ]
[ sort="name_asc" ]
[ showaction="y|n" ]
[ showfind="y|n" ]
[ showid="y|n" ]
[ showicon="y|n" ]
[ showname="y|n" ]
[ showfilename="y|n" ]
[ showsize="y|n" ]
[ showdescription="y|n" ]
[ showcreated="y|n" ]
[ showhits="y|n" ]
[ showlockedby="y|n" ]
[ showlmodified="y|n" ]
[ showauthor="y|n" ]
[ showcreator="y|n" ]
[ showgallery="y|n" ]
[ showfiles="y|n" ]
[ slideshow="y|n" ]
)}
Title
{FILES}
Flash video
Displays a SWF on the wiki page
{flash
movie="Complete URL to the movie to include."
[ width="Default width: 425" ]
[ height="Default height: 350" ]
[ quality="Flash video quality. Default value: high" ]
}
Group
Display wiki text if user is in one of listed groups
{GROUP(
[ groups="Pipe separated list of groups allowed to view the block. ex: Admins|Developers" ]
[ notgroups="Pipe separated list of groups denied from viewing the block. ex: Anonymous|Managers" ]
)}
Wiki text to display if conditions are met. The body may contain {ELSE}. Text after the marker will be displayed to users not matching the condition.
{GROUP}
Img
Displays an image.
{img
[ src="Full URL to the image to display." ]
[ alt="Alternate text to display if impossible to load the image." ]
[ height="Height of the image to display." ]
[ width="Width of the image to display." ]
[ link="Alias: lnk. Location the image should point to." ]
[ rel=""rel" attribute to add to the link." ]
[ title="Description." ]
[ align="Image alignment in the page. (left, right, center) Uses HTML IMG tag." ]
[ imalign="Image alignment in the flow of the document. (left, right, none) Uses CSS float property." ]
[ desc="Image description to display on the page." ]
[ usemap="Name of the image map to use for the image." ]
[ class="Style to apply to the image." ]
}
Include
Include a page's content.
{include
page="Wiki page name to include."
[ start="When only a portion of the page should be included, specify the marker from which inclusion should start." ]
[ stop="When only a portion of the page should be included, specify the marker at which inclusion should end." ]
}
Mediaplayer
Simple mp3 or flv Player
{mediaplayer
[ mp3="Complete URL to the mp3 to include." ]
[ flv="Complete URL to the flv to include." ]
[ style="One of:mini|normal|maxi|multi" ]
}
Insert Module
Displays a module inlined in page. More parameters can be added, not supported by UI.
{module
module="Module name as known in Tikiwiki."
[ float="left|right|none" ]
[ decoration="y|n" ]
[ flip="y|n" ]
[ max="y|n" ]
[ np="0|1" ]
[ notitle="y|n" ]
}
Mouse Over
Create a mouseover feature on some text
{MOUSEOVER(
label="Text displayed on the page. The body is the mouseover content"
[ url="Destination link when moused-over text is clicked. Use http:// for external links" ]
[ text="DEPRECATED Text displayed on the mouseover. The body contains the text of the page." ]
[ width="Mouse over box width. Default: 400px" ]
[ height="Mouse over box height. Default: 200px" ]
[ offsetx="Shifts the overlay to the right by the specified amount of pixels in relation to the cursor. Default: 5px" ]
[ offsety="Shifts the overlay to the bottom by the specified amount of pixels in relation to the cursor. Default: 0px" ]
[ parse="y|n, parse the body of the plugin as wiki content. (Default to y)" ]
[ bgcolor="Default: #F5F5F5" ]
[ textcolor="#FFFFFF" ]
[ sticky="y|n, when enabled, popup stays visible until an other one is displayed or it is clicked." ]
[ padding="Default: 5px" ]
)}
Mouseover text if param label exists. Page text if text param exists
{MOUSEOVER}
Quote
Quote text by surrounding the text with a box, like the [QUOTE] BBCode
{QUOTE(
[ replyto="Name of the quoted person." ]
)}
Quoted text
{QUOTE}
Remarks Box
Displays a comment, tip, note or warning box
{REMARKSBOX(
type="tip|comment|note|warning"
title="Label displayed above the remark."
[ highlight="y|n" ]
[ icon="Icon ID." ]
)}
remarks text
{REMARKSBOX}
RSS Feed
Inserts an RSS feed output.
{rss
id="List of feed IDs separated by colons. ex: feedId:feedId2"
[ max="Amount of results displayed." ]
[ date="0|1" ]
[ desc="0|1|max length" ]
[ author="0|1" ]
}
Sort
Sorts the plugin content in the wiki page
{SORT(
[ sort="asc|desc|shuffle" ]
)}
Data to sort, one entry per line.
{SORT}
Split
Split a page into rows and columns
{split
[ joincols="y|n Generate the colspan attribute if columns are missing" ]
[ fixedsize="y|n Generate the width attribute on the columns" ]
[ colsize="?" ]
[ first="col|line" ]
[ edit="y|n Display edit icon for each section" ]
[ customclass="add a class to customize the design" ]
}
Subscript
Displays text in subscript.
{SUB( )}
text
{SUB}
Superscript
Displays text in superscript (exponent).
{SUP( )}
text
{SUP}
Thumbnail
Displays the thumbnail for an image
{THUMB(
[ file="File ID from the file gallery." ]
[ id="Image ID from the image gallery." ]
[ image="URL to the image." ]
[ max="Maximum width or height for the image." ]
[ float="left|right|none" ]
[ url="Link target of the image." ]
[ original="y|n" ]
[ sticky="y|n" ]
)}
description
{THUMB}
Youtube
Display youtube video in a wiki page
{youtube
movie="URL to the Youtube video"
[ width="Width in pixels" ]
[ height="Height in pixels" ]
[ quality="quality" ]
}

Search

in:

Theme: Faulkner

Shoutbox

warande, 04:01 am, 09/04/2010: they are here, alive and allmost kicking, got to run, need to prepare a hughe BBQ for tonight
Melvang, 05:05 pm, 09/02/2010: We'll get there when we get there. Don't make me pull this car over.
RIPCORD, 11:16 am, 09/01/2010: Are we there yet? Are we there yet?
Walker, 12:06 pm, 08/31/2010: Make that 2 days
warande, 07:15 pm, 08/28/2010: i'll see you in 5 day's woot