Portal Engine Questions on portal engine and web parts.
Version 7.x > Portal Engine > Macro Function List View modes: 
User avatar
Member
Member
nanite2000 - 4/8/2013 10:03:49 PM
   
Macro Function List
Is there a complete list of K# Macros anywhere that I can refer to?

I feel like I'm running around in the dark trying to figure out where a function exists (or even if it exists at all).

The documentation is of no help whatsoever.

User avatar
Kentico Legend
Kentico Legend
Brenden Kehren - 4/9/2013 9:05:37 AM
   
RE:Macro Function List
Not sure if that is provided or not but when you're creating a macro you can see the ones that are available in the list. I'd also suggest downloading this macro tester Karol created as it helps considerably when you are attempting to create a macro yourself.

User avatar
Member
Member
nanite2000 - 4/9/2013 4:12:11 PM
   
RE:Macro Function List
FroggEye wrote: Not sure if that is provided or not but when you're creating a macro you can see the ones that are available in the list. I'd also suggest downloading this macro tester Karol created as it helps considerably when you are attempting to create a macro yourself.

That macro tester helps a little, but still requires me to search every conceivable branch of the macro tree hierarchy to find a function that may (or may not) exist.

Also, it doesn't really answer the bigger question - where is the macro function reference list, and the associated documentation for those functions?

How do Kentico expect us developers to use their tools when they don't provide proper documentation?

User avatar
Kentico Legend
Kentico Legend
Brenden Kehren - 4/9/2013 4:21:20 PM
   
RE:Macro Function List
As I stated, I don't believe there is a full documented list of those available. However if you check here Martin talks about usnig the Object Browser to get a similar view you see when creating a macro. IMHO, the documentation is good in comparison to other CMS solutions I've worked with, where you get little or none. I say if you're a developer who is passionate about using and developing within Kentico, then you will find a way to learn what K# Macros are available with our without documentation. :)

User avatar
Member
Member
nanite2000 - 4/9/2013 4:45:50 PM
   
RE:Macro Function List
FroggEye wrote: I say if you're a developer who is passionate about using and developing within Kentico, then you will find a way to learn what K# Macros are available with our without documentation. :)

I'm really not passionate about developing in Kentico. If you enjoy spending time working around Kentico's shortcomings, then I'm happy for you - but it is not something I enjoy.

However, I am passionate about building great websites, and I dislike any tool that prevents me from achieving that task.

Kentico's poor documentation prevents me from achieving my task.

I think Kentico is a great product that is held back by poor quality control and poor documentation. Umbraco may not offer much out of the box, but at least it's clear about what it does and does not provide, and there is great community support. At least with Umbraco I know I'm going to have to spend x hours building a specific function, and can plan for it in advance.

It's really frustrating when you pay thousands for a product that advertises certain time saving features, and those features fail to work as you expect, causing you to spend many unnecessary hours rewriting and redesigning your website just to make it work.

User avatar
Certified Developer 13
Certified Developer 13
kentico-jx2tech - 4/9/2013 6:22:55 PM
   
RE:Macro Function List
Not sure if it will help, but here is list of the Available macro methods.

The Macro expressions section in the devguide is worth a read in addition to the sources FroggEye linked.

User avatar
Member
Member
nanite2000 - 4/9/2013 6:31:54 PM
   
RE:Macro Function List
kentico-jx2tech wrote: Not sure if it will help, but here is list of the Available macro methods.

The Macro expressions section in the devguide is worth a read in addition to the sources FroggEye linked.

Unfortunately, those pages do not represent the complete list of Macro functions available.

Let's say a function exists in the API. How can I find out if that same function (or an equivalent) is also available as a Macro?

User avatar
Certified Developer 13
Certified Developer 13
kentico-jx2tech - 4/9/2013 7:29:31 PM
   
RE:Macro Function List
I would first search the Object Browser in Visual Studio or the Kentico CMS API Reference and see if there is a similar function in one of the macro classes. If i can't find it there, I turn to my favorite resource-- support(at)kentico.com Juraj never sleeps ;)

Adding your suggestions to the UserVoice about documentation improvements will help too. Kentico does a pretty good job listening to the developers.

User avatar
Kentico Legend
Kentico Legend
Brenden Kehren - 4/9/2013 10:16:50 PM
   
RE:Macro Function List
nanite2000 wrote: I think Kentico is a great product that is held back by poor quality control and poor documentation. Umbraco may not offer much out of the box, but at least it's clear about what it does and does not provide, and there is great community support. At least with Umbraco I know I'm going to have to spend x hours building a specific function, and can plan for it in advance.

It's really frustrating when you pay thousands for a product that advertises certain time saving features, and those features fail to work as you expect, causing you to spend many unnecessary hours rewriting and redesigning your website just to make it work.

Its unfortunate you feel this way. What I can say is there are plenty of examples of creating webparts and other development tasks but there is no possible way one can state you will spend X hours to build a function as all functions differ. Coding in .net is coding in .net. If you choose, create a bunch of ascx controls and place them in the User Control webpart, its quick and easy although offers content editors very little customization. There are many Kentico partners who have done much more than Kentico could have ever imagined, although I don't believe many of them spend their time on this forum providing "support", which I believe would be very helpful.

Support is included with your purchase, I suggest contacting them for further information. I've personally met a lot of the development team and they are great to work with and are very open to suggestions and changes.

User avatar
Kentico Support
Kentico Support
kentico_jurajo - 4/9/2013 11:14:59 PM
   
RE:Macro Function List
Hi,

Maybe it would be also faster if you could also describe the thing you are struggling with so either guys from Kentico or our community can help you to achieve your goal + we will see whether docs are available or not and if not, we will know what to improve and add for the future.

Btw. The documentation should be improved in version 8 - but, I think, there will be room to improve as the things will be changing too in the future.

Best regards,
Juraj Ondrus