add custom classes to confluence

Hi , how can i add my own java classes to confluence and how can i use their methods thanks

2 answers

This widget could not be displayed.

That's a very vague question - you might get a more useful answer if you tell us what you actually need to do, rather than start with the "how".

As a generalised answer though, I'd say "write an add on" - start at https://developer.atlassian.com/display/CONFDEV/Writing+Confluence+Plugins where you'll find you can write whatever you want, as classes, include your own libraries and make direct use of the internals of Confluence.

i want to write some classes to format the dates ( something like dateformatter.class) and use their methods inteadof dateformatter methods in vm files

can i modify this built-in class instead of writing new one?

thanks a lot

Ok, that's replacing stuff, rather than adding, which is a little more complex. I don't believe plugins can simply replace classes in the core of Confluence, and I don't believe they can subvert and override existing classes either. Via a plugin, they can extend and reuse, but that doesn't mean you can modify existing stuff.

I've got four basic approaches, using the dateformatter example you've given:

  1. Write a plugin that adds your new classes, so that they're available to Confluence generally. Then, go into the .vm files in Confluence, identify where the date formatter is used and change the .vm so that they use your class instead.
  2. Write your classes with the same name as the existing ones in Confluence and then strip them from your Confluence install and push yours in.
  3. Download the source of Confluence, modify the code directly and re-compile it
  4. Question the requirement - what is actually wrong with the date formatting? It might be that the classes support your need and you only actually need to tweak some settings (UI, environment, parameter, etc)

i try (2) but when i replace my class , confluence failed to start up


i want to convert Gregorian date to solar date

wich approach is better for this purpose?

if i try (1) how can i call my methods?

thanks

For (2), you need to read the log file for the errors. As you are replacing classes, you need to make sure that your new classes implement the same functions as the existing classes, at the very least for all of the calls Confluence makes. With date functions that could get quite messy because there's quite a lot there, and you'll have to replace all the input and output. I'd generally only recommend this approach for small, minor changes that don't actually change much (the only time I've personally used it was to enable the use of fractions in Jira's time-tracking field, which was minor because it was simply more clever parsing of input)

For (1), I already said - you would need to modify the .vm files that format dates so that they use your classes instead of the built-in ones.

This widget could not be displayed.

i want to write some classes to format the dates ( something like dateformatter.class) and use their methods inteadof dateformatter methods in vm files

can i modify this built-in class instead of writing new one?

thanks a lot

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Jul 30, 2018 in Confluence

How Manon Soubies-Camy uses Confluence + Trello to organize webinar notes and her knitting stash

@Manon Soubies-Camy is an engineer who has been an avid Atlassian user since 2014. She helps companies of all sizes transform the way they work with the Atlassian stack, including Jira and Confl...

866 views 8 13
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you