system.api.php 198 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010
  1. <?php
  2. /**
  3. * @file
  4. * Hooks provided by Drupal core and the System module.
  5. */
  6. /**
  7. * @addtogroup hooks
  8. * @{
  9. */
  10. /**
  11. * Defines one or more hooks that are exposed by a module.
  12. *
  13. * Normally hooks do not need to be explicitly defined. However, by declaring a
  14. * hook explicitly, a module may define a "group" for it. Modules that implement
  15. * a hook may then place their implementation in either $module.module or in
  16. * $module.$group.inc. If the hook is located in $module.$group.inc, then that
  17. * file will be automatically loaded when needed.
  18. * In general, hooks that are rarely invoked and/or are very large should be
  19. * placed in a separate include file, while hooks that are very short or very
  20. * frequently called should be left in the main module file so that they are
  21. * always available.
  22. *
  23. * @return
  24. * An associative array whose keys are hook names and whose values are an
  25. * associative array containing:
  26. * - group: A string defining the group to which the hook belongs. The module
  27. * system will determine whether a file with the name $module.$group.inc
  28. * exists, and automatically load it when required.
  29. *
  30. * See system_hook_info() for all hook groups defined by Drupal core.
  31. *
  32. * @see hook_hook_info_alter().
  33. */
  34. function hook_hook_info() {
  35. $hooks['token_info'] = array(
  36. 'group' => 'tokens',
  37. );
  38. $hooks['tokens'] = array(
  39. 'group' => 'tokens',
  40. );
  41. return $hooks;
  42. }
  43. /**
  44. * Alter information from hook_hook_info().
  45. *
  46. * @param $hooks
  47. * Information gathered by module_hook_info() from other modules'
  48. * implementations of hook_hook_info(). Alter this array directly.
  49. * See hook_hook_info() for information on what this may contain.
  50. */
  51. function hook_hook_info_alter(&$hooks) {
  52. // Our module wants to completely override the core tokens, so make
  53. // sure the core token hooks are not found.
  54. $hooks['token_info']['group'] = 'mytokens';
  55. $hooks['tokens']['group'] = 'mytokens';
  56. }
  57. /**
  58. * Inform the base system and the Field API about one or more entity types.
  59. *
  60. * Inform the system about one or more entity types (i.e., object types that
  61. * can be loaded via entity_load() and, optionally, to which fields can be
  62. * attached).
  63. *
  64. * @return
  65. * An array whose keys are entity type names and whose values identify
  66. * properties of those types that the system needs to know about:
  67. * - label: The human-readable name of the type.
  68. * - controller class: The name of the class that is used to load the objects.
  69. * The class has to implement the DrupalEntityControllerInterface interface.
  70. * Leave blank to use the DrupalDefaultEntityController implementation.
  71. * - base table: (used by DrupalDefaultEntityController) The name of the
  72. * entity type's base table.
  73. * - revision table: The name of the entity type's revision table (if any).
  74. * - static cache: (used by DrupalDefaultEntityController) FALSE to disable
  75. * static caching of entities during a page request. Defaults to TRUE.
  76. * - field cache: (used by Field API loading and saving of field data) FALSE
  77. * to disable Field API's persistent cache of field data. Only recommended
  78. * if a higher level persistent cache is available for the entity type.
  79. * Defaults to TRUE.
  80. * - load hook: The name of the hook which should be invoked by
  81. * DrupalDefaultEntityController:attachLoad(), for example 'node_load'.
  82. * - uri callback: The name of an implementation of
  83. * callback_entity_info_uri().
  84. * - label callback: (optional) The name of an implementation of
  85. * callback_entity_info_label(), which returns the label of the entity. The
  86. * entity label is the main string associated with an entity; for example,
  87. * the title of a node or the subject of a comment. If there is an entity
  88. * object property that defines the label, then using the 'label' element of
  89. * the 'entity keys' return value component suffices to provide this
  90. * information (see below). Alternatively, specifying this callback allows
  91. * more complex logic to determine the label of an entity. See also the
  92. * entity_label() function, which implements this logic.
  93. * - language callback: (optional) The name of an implementation of
  94. * callback_entity_info_language(). In most situations, when needing to
  95. * determine this value, inspecting a property named after the 'language'
  96. * element of the 'entity keys' should be enough. The language callback is
  97. * meant to be used primarily for temporary alterations of the property
  98. * value: entity-defining modules are encouraged to always define a
  99. * language property, instead of using the callback as main entity language
  100. * source. In fact not having a language property defined is likely to
  101. * prevent an entity from being queried by language. Moreover, given that
  102. * entity_language() is not necessarily used everywhere it would be
  103. * appropriate, modules implementing the language callback should be aware
  104. * that this might not be always called.
  105. * - fieldable: Set to TRUE if you want your entity type to accept fields
  106. * being attached to it.
  107. * - translation: An associative array of modules registered as field
  108. * translation handlers. Array keys are the module names, array values
  109. * can be any data structure the module uses to provide field translation.
  110. * Any empty value disallows the module to appear as a translation handler.
  111. * - entity keys: (optional) An array describing how the Field API can extract
  112. * the information it needs from the objects of the type. Elements:
  113. * - id: The name of the property that contains the primary id of the
  114. * entity. Every entity object passed to the Field API must have this
  115. * property and its value must be numeric.
  116. * - revision: The name of the property that contains the revision id of
  117. * the entity. The Field API assumes that all revision ids are unique
  118. * across all entities of a type. This entry can be omitted if the
  119. * entities of this type are not versionable. Defaults to an empty string.
  120. * - bundle: The name of the property that contains the bundle name for the
  121. * entity. The bundle name defines which set of fields are attached to
  122. * the entity (e.g. what nodes call "content type"). This entry can be
  123. * omitted if this entity type exposes a single bundle (all entities have
  124. * the same collection of fields). The name of this single bundle will be
  125. * the same as the entity type. Defaults to an empty string.
  126. * - label: The name of the property that contains the entity label. For
  127. * example, if the entity's label is located in $entity->subject, then
  128. * 'subject' should be specified here. If complex logic is required to
  129. * build the label, a 'label callback' should be defined instead (see
  130. * the 'label callback' section above for details).
  131. * - language: The name of the property, typically 'language', that contains
  132. * the language code representing the language the entity has been created
  133. * in. This value may be changed when editing the entity and represents
  134. * the language its textual components are supposed to have. If no
  135. * language property is available, the 'language callback' may be used
  136. * instead. This entry can be omitted if the entities of this type are not
  137. * language-aware.
  138. * - bundle keys: An array describing how the Field API can extract the
  139. * information it needs from the bundle objects for this type. This entry
  140. * is required if the 'path' provided in the 'bundles'/'admin' section
  141. * identifies the bundle using a named menu placeholder whose loader
  142. * callback returns an object (e.g., $vocabulary for taxonomy terms, or
  143. * $node_type for nodes). If the path does not include the bundle, or the
  144. * bundle is just a string rather than an automatically loaded object, then
  145. * this can be omitted. Elements:
  146. * - bundle: The name of the property of the bundle object that contains
  147. * the name of the bundle object.
  148. * - bundles: An array describing all bundles for this object type. Keys are
  149. * bundles machine names, as found in the objects' 'bundle' property
  150. * (defined in the 'entity keys' entry above). This entry can be omitted if
  151. * this entity type exposes a single bundle (all entities have the same
  152. * collection of fields). The name of this single bundle will be the same as
  153. * the entity type. Elements:
  154. * - label: The human-readable name of the bundle.
  155. * - uri callback: Same as the 'uri callback' key documented above for the
  156. * entity type, but for the bundle only. When determining the URI of an
  157. * entity, if a 'uri callback' is defined for both the entity type and
  158. * the bundle, the one for the bundle is used.
  159. * - admin: An array of information that allows Field UI pages to attach
  160. * themselves to the existing administration pages for the bundle.
  161. * Elements:
  162. * - path: the path of the bundle's main administration page, as defined
  163. * in hook_menu(). If the path includes a placeholder for the bundle,
  164. * the 'bundle argument' and 'real path' keys below are required.
  165. * - bundle argument: The position of the bundle placeholder in 'path', if
  166. * any.
  167. * - real path: The actual path (no placeholder) of the bundle's main
  168. * administration page. This will be used to generate links.
  169. * - access callback: As in hook_menu(). 'user_access' will be assumed if
  170. * no value is provided.
  171. * - access arguments: As in hook_menu().
  172. * - view modes: An array describing the view modes for the entity type. View
  173. * modes let entities be displayed differently depending on the context.
  174. * For instance, a node can be displayed differently on its own page
  175. * ('full' mode), on the home page or taxonomy listings ('teaser' mode), or
  176. * in an RSS feed ('rss' mode). Modules taking part in the display of the
  177. * entity (notably the Field API) can adjust their behavior depending on
  178. * the requested view mode. An additional 'default' view mode is available
  179. * for all entity types. This view mode is not intended for actual entity
  180. * display, but holds default display settings. For each available view
  181. * mode, administrators can configure whether it should use its own set of
  182. * field display settings, or just replicate the settings of the 'default'
  183. * view mode, thus reducing the amount of display configurations to keep
  184. * track of. Keys of the array are view mode names. Each view mode is
  185. * described by an array with the following key/value pairs:
  186. * - label: The human-readable name of the view mode
  187. * - custom settings: A boolean specifying whether the view mode should by
  188. * default use its own custom field display settings. If FALSE, entities
  189. * displayed in this view mode will reuse the 'default' display settings
  190. * by default (e.g. right after the module exposing the view mode is
  191. * enabled), but administrators can later use the Field UI to apply custom
  192. * display settings specific to the view mode.
  193. *
  194. * @see entity_load()
  195. * @see hook_entity_info_alter()
  196. */
  197. function hook_entity_info() {
  198. $return = array(
  199. 'node' => array(
  200. 'label' => t('Node'),
  201. 'controller class' => 'NodeController',
  202. 'base table' => 'node',
  203. 'revision table' => 'node_revision',
  204. 'uri callback' => 'node_uri',
  205. 'fieldable' => TRUE,
  206. 'translation' => array(
  207. 'locale' => TRUE,
  208. ),
  209. 'entity keys' => array(
  210. 'id' => 'nid',
  211. 'revision' => 'vid',
  212. 'bundle' => 'type',
  213. 'language' => 'language',
  214. ),
  215. 'bundle keys' => array(
  216. 'bundle' => 'type',
  217. ),
  218. 'bundles' => array(),
  219. 'view modes' => array(
  220. 'full' => array(
  221. 'label' => t('Full content'),
  222. 'custom settings' => FALSE,
  223. ),
  224. 'teaser' => array(
  225. 'label' => t('Teaser'),
  226. 'custom settings' => TRUE,
  227. ),
  228. 'rss' => array(
  229. 'label' => t('RSS'),
  230. 'custom settings' => FALSE,
  231. ),
  232. ),
  233. ),
  234. );
  235. // Search integration is provided by node.module, so search-related
  236. // view modes for nodes are defined here and not in search.module.
  237. if (module_exists('search')) {
  238. $return['node']['view modes'] += array(
  239. 'search_index' => array(
  240. 'label' => t('Search index'),
  241. 'custom settings' => FALSE,
  242. ),
  243. 'search_result' => array(
  244. 'label' => t('Search result highlighting input'),
  245. 'custom settings' => FALSE,
  246. ),
  247. );
  248. }
  249. // Bundles must provide a human readable name so we can create help and error
  250. // messages, and the path to attach Field admin pages to.
  251. foreach (node_type_get_names() as $type => $name) {
  252. $return['node']['bundles'][$type] = array(
  253. 'label' => $name,
  254. 'admin' => array(
  255. 'path' => 'admin/structure/types/manage/%node_type',
  256. 'real path' => 'admin/structure/types/manage/' . str_replace('_', '-', $type),
  257. 'bundle argument' => 4,
  258. 'access arguments' => array('administer content types'),
  259. ),
  260. );
  261. }
  262. return $return;
  263. }
  264. /**
  265. * Alter the entity info.
  266. *
  267. * Modules may implement this hook to alter the information that defines an
  268. * entity. All properties that are available in hook_entity_info() can be
  269. * altered here.
  270. *
  271. * @param $entity_info
  272. * The entity info array, keyed by entity name.
  273. *
  274. * @see hook_entity_info()
  275. */
  276. function hook_entity_info_alter(&$entity_info) {
  277. // Set the controller class for nodes to an alternate implementation of the
  278. // DrupalEntityController interface.
  279. $entity_info['node']['controller class'] = 'MyCustomNodeController';
  280. }
  281. /**
  282. * Act on entities when loaded.
  283. *
  284. * This is a generic load hook called for all entity types loaded via the
  285. * entity API.
  286. *
  287. * @param $entities
  288. * The entities keyed by entity ID.
  289. * @param $type
  290. * The type of entities being loaded (i.e. node, user, comment).
  291. */
  292. function hook_entity_load($entities, $type) {
  293. foreach ($entities as $entity) {
  294. $entity->foo = mymodule_add_something($entity, $type);
  295. }
  296. }
  297. /**
  298. * Act on an entity before it is about to be created or updated.
  299. *
  300. * @param $entity
  301. * The entity object.
  302. * @param $type
  303. * The type of entity being saved (i.e. node, user, comment).
  304. */
  305. function hook_entity_presave($entity, $type) {
  306. $entity->changed = REQUEST_TIME;
  307. }
  308. /**
  309. * Act on entities when inserted.
  310. *
  311. * @param $entity
  312. * The entity object.
  313. * @param $type
  314. * The type of entity being inserted (i.e. node, user, comment).
  315. */
  316. function hook_entity_insert($entity, $type) {
  317. // Insert the new entity into a fictional table of all entities.
  318. $info = entity_get_info($type);
  319. list($id) = entity_extract_ids($type, $entity);
  320. db_insert('example_entity')
  321. ->fields(array(
  322. 'type' => $type,
  323. 'id' => $id,
  324. 'created' => REQUEST_TIME,
  325. 'updated' => REQUEST_TIME,
  326. ))
  327. ->execute();
  328. }
  329. /**
  330. * Act on entities when updated.
  331. *
  332. * @param $entity
  333. * The entity object.
  334. * @param $type
  335. * The type of entity being updated (i.e. node, user, comment).
  336. */
  337. function hook_entity_update($entity, $type) {
  338. // Update the entity's entry in a fictional table of all entities.
  339. $info = entity_get_info($type);
  340. list($id) = entity_extract_ids($type, $entity);
  341. db_update('example_entity')
  342. ->fields(array(
  343. 'updated' => REQUEST_TIME,
  344. ))
  345. ->condition('type', $type)
  346. ->condition('id', $id)
  347. ->execute();
  348. }
  349. /**
  350. * Act on entities when deleted.
  351. *
  352. * @param $entity
  353. * The entity object.
  354. * @param $type
  355. * The type of entity being deleted (i.e. node, user, comment).
  356. */
  357. function hook_entity_delete($entity, $type) {
  358. // Delete the entity's entry from a fictional table of all entities.
  359. $info = entity_get_info($type);
  360. list($id) = entity_extract_ids($type, $entity);
  361. db_delete('example_entity')
  362. ->condition('type', $type)
  363. ->condition('id', $id)
  364. ->execute();
  365. }
  366. /**
  367. * Alter or execute an EntityFieldQuery.
  368. *
  369. * @param EntityFieldQuery $query
  370. * An EntityFieldQuery. One of the most important properties to be changed is
  371. * EntityFieldQuery::executeCallback. If this is set to an existing function,
  372. * this function will get the query as its single argument and its result
  373. * will be the returned as the result of EntityFieldQuery::execute(). This can
  374. * be used to change the behavior of EntityFieldQuery entirely. For example,
  375. * the default implementation can only deal with one field storage engine, but
  376. * it is possible to write a module that can query across field storage
  377. * engines. Also, the default implementation presumes entities are stored in
  378. * SQL, but the execute callback could instead query any other entity storage,
  379. * local or remote.
  380. *
  381. * Note the $query->altered attribute which is TRUE in case the query has
  382. * already been altered once. This happens with cloned queries.
  383. * If there is a pager, then such a cloned query will be executed to count
  384. * all elements. This query can be detected by checking for
  385. * ($query->pager && $query->count), allowing the driver to return 0 from
  386. * the count query and disable the pager.
  387. */
  388. function hook_entity_query_alter($query) {
  389. $query->executeCallback = 'my_module_query_callback';
  390. }
  391. /**
  392. * Act on entities being assembled before rendering.
  393. *
  394. * @param $entity
  395. * The entity object.
  396. * @param $type
  397. * The type of entity being rendered (i.e. node, user, comment).
  398. * @param $view_mode
  399. * The view mode the entity is rendered in.
  400. * @param $langcode
  401. * The language code used for rendering.
  402. *
  403. * The module may add elements to $entity->content prior to rendering. The
  404. * structure of $entity->content is a renderable array as expected by
  405. * drupal_render().
  406. *
  407. * @see hook_entity_view_alter()
  408. * @see hook_comment_view()
  409. * @see hook_node_view()
  410. * @see hook_user_view()
  411. */
  412. function hook_entity_view($entity, $type, $view_mode, $langcode) {
  413. $entity->content['my_additional_field'] = array(
  414. '#markup' => $additional_field,
  415. '#weight' => 10,
  416. '#theme' => 'mymodule_my_additional_field',
  417. );
  418. }
  419. /**
  420. * Alter the results of ENTITY_view().
  421. *
  422. * This hook is called after the content has been assembled in a structured
  423. * array and may be used for doing processing which requires that the complete
  424. * entity content structure has been built.
  425. *
  426. * If a module wishes to act on the rendered HTML of the entity rather than the
  427. * structured content array, it may use this hook to add a #post_render
  428. * callback. Alternatively, it could also implement hook_preprocess_ENTITY().
  429. * See drupal_render() and theme() for details.
  430. *
  431. * @param $build
  432. * A renderable array representing the entity content.
  433. * @param $type
  434. * The type of entity being rendered (i.e. node, user, comment).
  435. *
  436. * @see hook_entity_view()
  437. * @see hook_comment_view_alter()
  438. * @see hook_node_view_alter()
  439. * @see hook_taxonomy_term_view_alter()
  440. * @see hook_user_view_alter()
  441. */
  442. function hook_entity_view_alter(&$build, $type) {
  443. if ($build['#view_mode'] == 'full' && isset($build['an_additional_field'])) {
  444. // Change its weight.
  445. $build['an_additional_field']['#weight'] = -10;
  446. // Add a #post_render callback to act on the rendered HTML of the entity.
  447. $build['#post_render'][] = 'my_module_node_post_render';
  448. }
  449. }
  450. /**
  451. * Change the view mode of an entity that is being displayed.
  452. *
  453. * @param string $view_mode
  454. * The view_mode that is to be used to display the entity.
  455. * @param array $context
  456. * Array with contextual information, including:
  457. * - entity_type: The type of the entity that is being viewed.
  458. * - entity: The entity object.
  459. * - langcode: The langcode the entity is being viewed in.
  460. */
  461. function hook_entity_view_mode_alter(&$view_mode, $context) {
  462. // For nodes, change the view mode when it is teaser.
  463. if ($context['entity_type'] == 'node' && $view_mode == 'teaser') {
  464. $view_mode = 'my_custom_view_mode';
  465. }
  466. }
  467. /**
  468. * Define administrative paths.
  469. *
  470. * Modules may specify whether or not the paths they define in hook_menu() are
  471. * to be considered administrative. Other modules may use this information to
  472. * display those pages differently (e.g. in a modal overlay, or in a different
  473. * theme).
  474. *
  475. * To change the administrative status of menu items defined in another module's
  476. * hook_menu(), modules should implement hook_admin_paths_alter().
  477. *
  478. * @return
  479. * An associative array. For each item, the key is the path in question, in
  480. * a format acceptable to drupal_match_path(). The value for each item should
  481. * be TRUE (for paths considered administrative) or FALSE (for non-
  482. * administrative paths).
  483. *
  484. * @see hook_menu()
  485. * @see drupal_match_path()
  486. * @see hook_admin_paths_alter()
  487. */
  488. function hook_admin_paths() {
  489. $paths = array(
  490. 'mymodule/*/add' => TRUE,
  491. 'mymodule/*/edit' => TRUE,
  492. );
  493. return $paths;
  494. }
  495. /**
  496. * Redefine administrative paths defined by other modules.
  497. *
  498. * @param $paths
  499. * An associative array of administrative paths, as defined by implementations
  500. * of hook_admin_paths().
  501. *
  502. * @see hook_admin_paths()
  503. */
  504. function hook_admin_paths_alter(&$paths) {
  505. // Treat all user pages as administrative.
  506. $paths['user'] = TRUE;
  507. $paths['user/*'] = TRUE;
  508. // Treat the forum topic node form as a non-administrative page.
  509. $paths['node/add/forum'] = FALSE;
  510. }
  511. /**
  512. * Act on entities as they are being prepared for view.
  513. *
  514. * Allows you to operate on multiple entities as they are being prepared for
  515. * view. Only use this if attaching the data during the entity_load() phase
  516. * is not appropriate, for example when attaching other 'entity' style objects.
  517. *
  518. * @param $entities
  519. * The entities keyed by entity ID.
  520. * @param $type
  521. * The type of entities being loaded (i.e. node, user, comment).
  522. * @param $langcode
  523. * The language to display the entity in.
  524. */
  525. function hook_entity_prepare_view($entities, $type, $langcode) {
  526. // Load a specific node into the user object for later theming.
  527. if ($type == 'user') {
  528. $nodes = mymodule_get_user_nodes(array_keys($entities));
  529. foreach ($entities as $uid => $entity) {
  530. $entity->user_node = $nodes[$uid];
  531. }
  532. }
  533. }
  534. /**
  535. * Perform periodic actions.
  536. *
  537. * Modules that require some commands to be executed periodically can
  538. * implement hook_cron(). The engine will then call the hook whenever a cron
  539. * run happens, as defined by the administrator. Typical tasks managed by
  540. * hook_cron() are database maintenance, backups, recalculation of settings
  541. * or parameters, automated mailing, and retrieving remote data.
  542. *
  543. * Short-running or non-resource-intensive tasks can be executed directly in
  544. * the hook_cron() implementation.
  545. *
  546. * Long-running tasks and tasks that could time out, such as retrieving remote
  547. * data, sending email, and intensive file tasks, should use the queue API
  548. * instead of executing the tasks directly. To do this, first define one or
  549. * more queues via hook_cron_queue_info(). Then, add items that need to be
  550. * processed to the defined queues.
  551. */
  552. function hook_cron() {
  553. // Short-running operation example, not using a queue:
  554. // Delete all expired records since the last cron run.
  555. $expires = variable_get('mymodule_cron_last_run', REQUEST_TIME);
  556. db_delete('mymodule_table')
  557. ->condition('expires', $expires, '>=')
  558. ->execute();
  559. variable_set('mymodule_cron_last_run', REQUEST_TIME);
  560. // Long-running operation example, leveraging a queue:
  561. // Fetch feeds from other sites.
  562. $result = db_query('SELECT * FROM {aggregator_feed} WHERE checked + refresh < :time AND refresh <> :never', array(
  563. ':time' => REQUEST_TIME,
  564. ':never' => AGGREGATOR_CLEAR_NEVER,
  565. ));
  566. $queue = DrupalQueue::get('aggregator_feeds');
  567. foreach ($result as $feed) {
  568. $queue->createItem($feed);
  569. }
  570. }
  571. /**
  572. * Declare queues holding items that need to be run periodically.
  573. *
  574. * While there can be only one hook_cron() process running at the same time,
  575. * there can be any number of processes defined here running. Because of
  576. * this, long running tasks are much better suited for this API. Items queued
  577. * in hook_cron() might be processed in the same cron run if there are not many
  578. * items in the queue, otherwise it might take several requests, which can be
  579. * run in parallel.
  580. *
  581. * @return
  582. * An associative array where the key is the queue name and the value is
  583. * again an associative array. Possible keys are:
  584. * - 'worker callback': The name of an implementation of
  585. * callback_queue_worker().
  586. * - 'time': (optional) How much time Drupal should spend on calling this
  587. * worker in seconds. Defaults to 15.
  588. * - 'skip on cron': (optional) Set to TRUE to avoid being processed during
  589. * cron runs (for example, if you want to control all queue execution
  590. * manually).
  591. *
  592. * @see hook_cron()
  593. * @see hook_cron_queue_info_alter()
  594. */
  595. function hook_cron_queue_info() {
  596. $queues['aggregator_feeds'] = array(
  597. 'worker callback' => 'aggregator_refresh',
  598. 'time' => 60,
  599. );
  600. return $queues;
  601. }
  602. /**
  603. * Alter cron queue information before cron runs.
  604. *
  605. * Called by drupal_cron_run() to allow modules to alter cron queue settings
  606. * before any jobs are processesed.
  607. *
  608. * @param array $queues
  609. * An array of cron queue information.
  610. *
  611. * @see hook_cron_queue_info()
  612. * @see drupal_cron_run()
  613. */
  614. function hook_cron_queue_info_alter(&$queues) {
  615. // This site has many feeds so let's spend 90 seconds on each cron run
  616. // updating feeds instead of the default 60.
  617. $queues['aggregator_feeds']['time'] = 90;
  618. }
  619. /**
  620. * Allows modules to declare their own Form API element types and specify their
  621. * default values.
  622. *
  623. * This hook allows modules to declare their own form element types and to
  624. * specify their default values. The values returned by this hook will be
  625. * merged with the elements returned by hook_form() implementations and so
  626. * can return defaults for any Form APIs keys in addition to those explicitly
  627. * mentioned below.
  628. *
  629. * Each of the form element types defined by this hook is assumed to have
  630. * a matching theme function, e.g. theme_elementtype(), which should be
  631. * registered with hook_theme() as normal.
  632. *
  633. * For more information about custom element types see the explanation at
  634. * http://drupal.org/node/169815.
  635. *
  636. * @return
  637. * An associative array describing the element types being defined. The array
  638. * contains a sub-array for each element type, with the machine-readable type
  639. * name as the key. Each sub-array has a number of possible attributes:
  640. * - "#input": boolean indicating whether or not this element carries a value
  641. * (even if it's hidden).
  642. * - "#process": array of callback functions taking $element, $form_state,
  643. * and $complete_form.
  644. * - "#after_build": array of callback functions taking $element and $form_state.
  645. * - "#validate": array of callback functions taking $form and $form_state.
  646. * - "#element_validate": array of callback functions taking $element and
  647. * $form_state.
  648. * - "#pre_render": array of callback functions taking $element and $form_state.
  649. * - "#post_render": array of callback functions taking $element and $form_state.
  650. * - "#submit": array of callback functions taking $form and $form_state.
  651. * - "#title_display": optional string indicating if and how #title should be
  652. * displayed, see theme_form_element() and theme_form_element_label().
  653. *
  654. * @see hook_element_info_alter()
  655. * @see system_element_info()
  656. */
  657. function hook_element_info() {
  658. $types['filter_format'] = array(
  659. '#input' => TRUE,
  660. );
  661. return $types;
  662. }
  663. /**
  664. * Alter the element type information returned from modules.
  665. *
  666. * A module may implement this hook in order to alter the element type defaults
  667. * defined by a module.
  668. *
  669. * @param $type
  670. * All element type defaults as collected by hook_element_info().
  671. *
  672. * @see hook_element_info()
  673. */
  674. function hook_element_info_alter(&$type) {
  675. // Decrease the default size of textfields.
  676. if (isset($type['textfield']['#size'])) {
  677. $type['textfield']['#size'] = 40;
  678. }
  679. }
  680. /**
  681. * Perform cleanup tasks.
  682. *
  683. * This hook is run at the end of most regular page requests. It is often
  684. * used for page logging and specialized cleanup. This hook MUST NOT print
  685. * anything because by the time it runs the response is already sent to
  686. * the browser.
  687. *
  688. * Only use this hook if your code must run even for cached page views.
  689. * If you have code which must run once on all non-cached pages, use
  690. * hook_init() instead. That is the usual case. If you implement this hook
  691. * and see an error like 'Call to undefined function', it is likely that
  692. * you are depending on the presence of a module which has not been loaded yet.
  693. * It is not loaded because Drupal is still in bootstrap mode.
  694. *
  695. * @param $destination
  696. * If this hook is invoked as part of a drupal_goto() call, then this argument
  697. * will be a fully-qualified URL that is the destination of the redirect.
  698. */
  699. function hook_exit($destination = NULL) {
  700. db_update('counter')
  701. ->expression('hits', 'hits + 1')
  702. ->condition('type', 1)
  703. ->execute();
  704. }
  705. /**
  706. * Perform necessary alterations to the JavaScript before it is presented on
  707. * the page.
  708. *
  709. * @param $javascript
  710. * An array of all JavaScript being presented on the page.
  711. *
  712. * @see drupal_add_js()
  713. * @see drupal_get_js()
  714. * @see drupal_js_defaults()
  715. */
  716. function hook_js_alter(&$javascript) {
  717. // Swap out jQuery to use an updated version of the library.
  718. $javascript['misc/jquery.js']['data'] = drupal_get_path('module', 'jquery_update') . '/jquery.js';
  719. }
  720. /**
  721. * Registers JavaScript/CSS libraries associated with a module.
  722. *
  723. * Modules implementing this return an array of arrays. The key to each
  724. * sub-array is the machine readable name of the library. Each library may
  725. * contain the following items:
  726. *
  727. * - 'title': The human readable name of the library.
  728. * - 'website': The URL of the library's web site.
  729. * - 'version': A string specifying the version of the library; intentionally
  730. * not a float because a version like "1.2.3" is not a valid float. Use PHP's
  731. * version_compare() to compare different versions.
  732. * - 'js': An array of JavaScript elements; each element's key is used as $data
  733. * argument, each element's value is used as $options array for
  734. * drupal_add_js(). To add library-specific (not module-specific) JavaScript
  735. * settings, the key may be skipped, the value must specify
  736. * 'type' => 'setting', and the actual settings must be contained in a 'data'
  737. * element of the value.
  738. * - 'css': Like 'js', an array of CSS elements passed to drupal_add_css().
  739. * - 'dependencies': An array of libraries that are required for a library. Each
  740. * element is an array listing the module and name of another library. Note
  741. * that all dependencies for each dependent library will also be added when
  742. * this library is added.
  743. *
  744. * Registered information for a library should contain re-usable data only.
  745. * Module- or implementation-specific data and integration logic should be added
  746. * separately.
  747. *
  748. * @return
  749. * An array defining libraries associated with a module.
  750. *
  751. * @see system_library()
  752. * @see drupal_add_library()
  753. * @see drupal_get_library()
  754. */
  755. function hook_library() {
  756. // Library One.
  757. $libraries['library-1'] = array(
  758. 'title' => 'Library One',
  759. 'website' => 'http://example.com/library-1',
  760. 'version' => '1.2',
  761. 'js' => array(
  762. drupal_get_path('module', 'my_module') . '/library-1.js' => array(),
  763. ),
  764. 'css' => array(
  765. drupal_get_path('module', 'my_module') . '/library-2.css' => array(
  766. 'type' => 'file',
  767. 'media' => 'screen',
  768. ),
  769. ),
  770. );
  771. // Library Two.
  772. $libraries['library-2'] = array(
  773. 'title' => 'Library Two',
  774. 'website' => 'http://example.com/library-2',
  775. 'version' => '3.1-beta1',
  776. 'js' => array(
  777. // JavaScript settings may use the 'data' key.
  778. array(
  779. 'type' => 'setting',
  780. 'data' => array('library2' => TRUE),
  781. ),
  782. ),
  783. 'dependencies' => array(
  784. // Require jQuery UI core by System module.
  785. array('system', 'ui'),
  786. // Require our other library.
  787. array('my_module', 'library-1'),
  788. // Require another library.
  789. array('other_module', 'library-3'),
  790. ),
  791. );
  792. return $libraries;
  793. }
  794. /**
  795. * Alters the JavaScript/CSS library registry.
  796. *
  797. * Allows certain, contributed modules to update libraries to newer versions
  798. * while ensuring backwards compatibility. In general, such manipulations should
  799. * only be done by designated modules, since most modules that integrate with a
  800. * certain library also depend on the API of a certain library version.
  801. *
  802. * @param $libraries
  803. * The JavaScript/CSS libraries provided by $module. Keyed by internal library
  804. * name and passed by reference.
  805. * @param $module
  806. * The name of the module that registered the libraries.
  807. *
  808. * @see hook_library()
  809. */
  810. function hook_library_alter(&$libraries, $module) {
  811. // Update Farbtastic to version 2.0.
  812. if ($module == 'system' && isset($libraries['farbtastic'])) {
  813. // Verify existing version is older than the one we are updating to.
  814. if (version_compare($libraries['farbtastic']['version'], '2.0', '<')) {
  815. // Update the existing Farbtastic to version 2.0.
  816. $libraries['farbtastic']['version'] = '2.0';
  817. $libraries['farbtastic']['js'] = array(
  818. drupal_get_path('module', 'farbtastic_update') . '/farbtastic-2.0.js' => array(),
  819. );
  820. }
  821. }
  822. }
  823. /**
  824. * Alter CSS files before they are output on the page.
  825. *
  826. * @param $css
  827. * An array of all CSS items (files and inline CSS) being requested on the page.
  828. *
  829. * @see drupal_add_css()
  830. * @see drupal_get_css()
  831. */
  832. function hook_css_alter(&$css) {
  833. // Remove defaults.css file.
  834. unset($css[drupal_get_path('module', 'system') . '/defaults.css']);
  835. }
  836. /**
  837. * Alter the commands that are sent to the user through the Ajax framework.
  838. *
  839. * @param $commands
  840. * An array of all commands that will be sent to the user.
  841. *
  842. * @see ajax_render()
  843. */
  844. function hook_ajax_render_alter(&$commands) {
  845. // Inject any new status messages into the content area.
  846. $commands[] = ajax_command_prepend('#block-system-main .content', theme('status_messages'));
  847. }
  848. /**
  849. * Add elements to a page before it is rendered.
  850. *
  851. * Use this hook when you want to add elements at the page level. For your
  852. * additions to be printed, they have to be placed below a top level array key
  853. * of the $page array that has the name of a region of the active theme.
  854. *
  855. * By default, valid region keys are 'page_top', 'header', 'sidebar_first',
  856. * 'content', 'sidebar_second' and 'page_bottom'. To get a list of all regions
  857. * of the active theme, use system_region_list($theme). Note that $theme is a
  858. * global variable.
  859. *
  860. * If you want to alter the elements added by other modules or if your module
  861. * depends on the elements of other modules, use hook_page_alter() instead which
  862. * runs after this hook.
  863. *
  864. * @param $page
  865. * Nested array of renderable elements that make up the page.
  866. *
  867. * @see hook_page_alter()
  868. * @see drupal_render_page()
  869. */
  870. function hook_page_build(&$page) {
  871. if (menu_get_object('node', 1)) {
  872. // We are on a node detail page. Append a standard disclaimer to the
  873. // content region.
  874. $page['content']['disclaimer'] = array(
  875. '#markup' => t('Acme, Inc. is not responsible for the contents of this sample code.'),
  876. '#weight' => 25,
  877. );
  878. }
  879. }
  880. /**
  881. * Alter a menu router item right after it has been retrieved from the database or cache.
  882. *
  883. * This hook is invoked by menu_get_item() and allows for run-time alteration of router
  884. * information (page_callback, title, and so on) before it is translated and checked for
  885. * access. The passed-in $router_item is statically cached for the current request, so this
  886. * hook is only invoked once for any router item that is retrieved via menu_get_item().
  887. *
  888. * Usually, modules will only want to inspect the router item and conditionally
  889. * perform other actions (such as preparing a state for the current request).
  890. * Note that this hook is invoked for any router item that is retrieved by
  891. * menu_get_item(), which may or may not be called on the path itself, so implementations
  892. * should check the $path parameter if the alteration should fire for the current request
  893. * only.
  894. *
  895. * @param $router_item
  896. * The menu router item for $path.
  897. * @param $path
  898. * The originally passed path, for which $router_item is responsible.
  899. * @param $original_map
  900. * The path argument map, as contained in $path.
  901. *
  902. * @see menu_get_item()
  903. */
  904. function hook_menu_get_item_alter(&$router_item, $path, $original_map) {
  905. // When retrieving the router item for the current path...
  906. if ($path == $_GET['q']) {
  907. // ...call a function that prepares something for this request.
  908. mymodule_prepare_something();
  909. }
  910. }
  911. /**
  912. * Define menu items and page callbacks.
  913. *
  914. * This hook enables modules to register paths in order to define how URL
  915. * requests are handled. Paths may be registered for URL handling only, or they
  916. * can register a link to be placed in a menu (usually the Navigation menu). A
  917. * path and its associated information is commonly called a "menu router item".
  918. * This hook is rarely called (for example, when modules are enabled), and
  919. * its results are cached in the database.
  920. *
  921. * hook_menu() implementations return an associative array whose keys define
  922. * paths and whose values are an associative array of properties for each
  923. * path. (The complete list of properties is in the return value section below.)
  924. *
  925. * @section sec_callback_funcs Callback Functions
  926. * The definition for each path may include a page callback function, which is
  927. * invoked when the registered path is requested. If there is no other
  928. * registered path that fits the requested path better, any further path
  929. * components are passed to the callback function. For example, your module
  930. * could register path 'abc/def':
  931. * @code
  932. * function mymodule_menu() {
  933. * $items['abc/def'] = array(
  934. * 'page callback' => 'mymodule_abc_view',
  935. * );
  936. * return $items;
  937. * }
  938. *
  939. * function mymodule_abc_view($ghi = 0, $jkl = '') {
  940. * // ...
  941. * }
  942. * @endcode
  943. * When path 'abc/def' is requested, no further path components are in the
  944. * request, and no additional arguments are passed to the callback function (so
  945. * $ghi and $jkl would take the default values as defined in the function
  946. * signature). When 'abc/def/123/foo' is requested, $ghi will be '123' and
  947. * $jkl will be 'foo'. Note that this automatic passing of optional path
  948. * arguments applies only to page and theme callback functions.
  949. *
  950. * @subsection sub_callback_arguments Callback Arguments
  951. * In addition to optional path arguments, the page callback and other callback
  952. * functions may specify argument lists as arrays. These argument lists may
  953. * contain both fixed/hard-coded argument values and integers that correspond
  954. * to path components. When integers are used and the callback function is
  955. * called, the corresponding path components will be substituted for the
  956. * integers. That is, the integer 0 in an argument list will be replaced with
  957. * the first path component, integer 1 with the second, and so on (path
  958. * components are numbered starting from zero). To pass an integer without it
  959. * being replaced with its respective path component, use the string value of
  960. * the integer (e.g., '1') as the argument value. This substitution feature
  961. * allows you to re-use a callback function for several different paths. For
  962. * example:
  963. * @code
  964. * function mymodule_menu() {
  965. * $items['abc/def'] = array(
  966. * 'page callback' => 'mymodule_abc_view',
  967. * 'page arguments' => array(1, 'foo'),
  968. * );
  969. * return $items;
  970. * }
  971. * @endcode
  972. * When path 'abc/def' is requested, the page callback function will get 'def'
  973. * as the first argument and (always) 'foo' as the second argument.
  974. *
  975. * If a page callback function uses an argument list array, and its path is
  976. * requested with optional path arguments, then the list array's arguments are
  977. * passed to the callback function first, followed by the optional path
  978. * arguments. Using the above example, when path 'abc/def/bar/baz' is requested,
  979. * mymodule_abc_view() will be called with 'def', 'foo', 'bar' and 'baz' as
  980. * arguments, in that order.
  981. *
  982. * Special care should be taken for the page callback drupal_get_form(), because
  983. * your specific form callback function will always receive $form and
  984. * &$form_state as the first function arguments:
  985. * @code
  986. * function mymodule_abc_form($form, &$form_state) {
  987. * // ...
  988. * return $form;
  989. * }
  990. * @endcode
  991. * See @link form_api Form API documentation @endlink for details.
  992. *
  993. * @section sec_path_wildcards Wildcards in Paths
  994. * @subsection sub_simple_wildcards Simple Wildcards
  995. * Wildcards within paths also work with integer substitution. For example,
  996. * your module could register path 'my-module/%/edit':
  997. * @code
  998. * $items['my-module/%/edit'] = array(
  999. * 'page callback' => 'mymodule_abc_edit',
  1000. * 'page arguments' => array(1),
  1001. * );
  1002. * @endcode
  1003. * When path 'my-module/foo/edit' is requested, integer 1 will be replaced
  1004. * with 'foo' and passed to the callback function. Note that wildcards may not
  1005. * be used as the first component.
  1006. *
  1007. * @subsection sub_autoload_wildcards Auto-Loader Wildcards
  1008. * Registered paths may also contain special "auto-loader" wildcard components
  1009. * in the form of '%mymodule_abc', where the '%' part means that this path
  1010. * component is a wildcard, and the 'mymodule_abc' part defines the prefix for a
  1011. * load function, which here would be named mymodule_abc_load(). When a matching
  1012. * path is requested, your load function will receive as its first argument the
  1013. * path component in the position of the wildcard; load functions may also be
  1014. * passed additional arguments (see "load arguments" in the return value
  1015. * section below). For example, your module could register path
  1016. * 'my-module/%mymodule_abc/edit':
  1017. * @code
  1018. * $items['my-module/%mymodule_abc/edit'] = array(
  1019. * 'page callback' => 'mymodule_abc_edit',
  1020. * 'page arguments' => array(1),
  1021. * );
  1022. * @endcode
  1023. * When path 'my-module/123/edit' is requested, your load function
  1024. * mymodule_abc_load() will be invoked with the argument '123', and should
  1025. * load and return an "abc" object with internal id 123:
  1026. * @code
  1027. * function mymodule_abc_load($abc_id) {
  1028. * return db_query("SELECT * FROM {mymodule_abc} WHERE abc_id = :abc_id", array(':abc_id' => $abc_id))->fetchObject();
  1029. * }
  1030. * @endcode
  1031. * This 'abc' object will then be passed into the callback functions defined
  1032. * for the menu item, such as the page callback function mymodule_abc_edit()
  1033. * to replace the integer 1 in the argument array. Note that a load function
  1034. * should return FALSE when it is unable to provide a loadable object. For
  1035. * example, the node_load() function for the 'node/%node/edit' menu item will
  1036. * return FALSE for the path 'node/999/edit' if a node with a node ID of 999
  1037. * does not exist. The menu routing system will return a 404 error in this case.
  1038. *
  1039. * @subsection sub_argument_wildcards Argument Wildcards
  1040. * You can also define a %wildcard_to_arg() function (for the example menu
  1041. * entry above this would be 'mymodule_abc_to_arg()'). The _to_arg() function
  1042. * is invoked to retrieve a value that is used in the path in place of the
  1043. * wildcard. A good example is user.module, which defines
  1044. * user_uid_optional_to_arg() (corresponding to the menu entry
  1045. * 'tracker/%user_uid_optional'). This function returns the user ID of the
  1046. * current user.
  1047. *
  1048. * The _to_arg() function will get called with three arguments:
  1049. * - $arg: A string representing whatever argument may have been supplied by
  1050. * the caller (this is particularly useful if you want the _to_arg()
  1051. * function only supply a (default) value if no other value is specified,
  1052. * as in the case of user_uid_optional_to_arg().
  1053. * - $map: An array of all path fragments (e.g. array('node','123','edit') for
  1054. * 'node/123/edit').
  1055. * - $index: An integer indicating which element of $map corresponds to $arg.
  1056. *
  1057. * _load() and _to_arg() functions may seem similar at first glance, but they
  1058. * have different purposes and are called at different times. _load()
  1059. * functions are called when the menu system is collecting arguments to pass
  1060. * to the callback functions defined for the menu item. _to_arg() functions
  1061. * are called when the menu system is generating links to related paths, such
  1062. * as the tabs for a set of MENU_LOCAL_TASK items.
  1063. *
  1064. * @section sec_render_tabs Rendering Menu Items As Tabs
  1065. * You can also make groups of menu items to be rendered (by default) as tabs
  1066. * on a page. To do that, first create one menu item of type MENU_NORMAL_ITEM,
  1067. * with your chosen path, such as 'foo'. Then duplicate that menu item, using a
  1068. * subdirectory path, such as 'foo/tab1', and changing the type to
  1069. * MENU_DEFAULT_LOCAL_TASK to make it the default tab for the group. Then add
  1070. * the additional tab items, with paths such as "foo/tab2" etc., with type
  1071. * MENU_LOCAL_TASK. Example:
  1072. * @code
  1073. * // Make "Foo settings" appear on the admin Config page
  1074. * $items['admin/config/system/foo'] = array(
  1075. * 'title' => 'Foo settings',
  1076. * 'type' => MENU_NORMAL_ITEM,
  1077. * // Page callback, etc. need to be added here.
  1078. * );
  1079. * // Make "Tab 1" the main tab on the "Foo settings" page
  1080. * $items['admin/config/system/foo/tab1'] = array(
  1081. * 'title' => 'Tab 1',
  1082. * 'type' => MENU_DEFAULT_LOCAL_TASK,
  1083. * // Access callback, page callback, and theme callback will be inherited
  1084. * // from 'admin/config/system/foo', if not specified here to override.
  1085. * );
  1086. * // Make an additional tab called "Tab 2" on "Foo settings"
  1087. * $items['admin/config/system/foo/tab2'] = array(
  1088. * 'title' => 'Tab 2',
  1089. * 'type' => MENU_LOCAL_TASK,
  1090. * // Page callback and theme callback will be inherited from
  1091. * // 'admin/config/system/foo', if not specified here to override.
  1092. * // Need to add access callback or access arguments.
  1093. * );
  1094. * @endcode
  1095. *
  1096. * @return
  1097. * An array of menu items. Each menu item has a key corresponding to the
  1098. * Drupal path being registered. The corresponding array value is an
  1099. * associative array that may contain the following key-value pairs:
  1100. * - "title": Required. The untranslated title of the menu item.
  1101. * - "title callback": Function to generate the title; defaults to t().
  1102. * If you require only the raw string to be output, set this to FALSE.
  1103. * - "title arguments": Arguments to send to t() or your custom callback,
  1104. * with path component substitution as described above.
  1105. * - "description": The untranslated description of the menu item.
  1106. * - "page callback": The function to call to display a web page when the user
  1107. * visits the path. If omitted, the parent menu item's callback will be used
  1108. * instead.
  1109. * - "page arguments": An array of arguments to pass to the page callback
  1110. * function, with path component substitution as described above.
  1111. * - "delivery callback": The function to call to package the result of the
  1112. * page callback function and send it to the browser. Defaults to
  1113. * drupal_deliver_html_page() unless a value is inherited from a parent menu
  1114. * item. Note that this function is called even if the access checks fail,
  1115. * so any custom delivery callback function should take that into account.
  1116. * See drupal_deliver_html_page() for an example.
  1117. * - "access callback": A function returning TRUE if the user has access
  1118. * rights to this menu item, and FALSE if not. It can also be a boolean
  1119. * constant instead of a function, and you can also use numeric values
  1120. * (will be cast to boolean). Defaults to user_access() unless a value is
  1121. * inherited from the parent menu item; only MENU_DEFAULT_LOCAL_TASK items
  1122. * can inherit access callbacks. To use the user_access() default callback,
  1123. * you must specify the permission to check as 'access arguments' (see
  1124. * below).
  1125. * - "access arguments": An array of arguments to pass to the access callback
  1126. * function, with path component substitution as described above. If the
  1127. * access callback is inherited (see above), the access arguments will be
  1128. * inherited with it, unless overridden in the child menu item.
  1129. * - "theme callback": (optional) A function returning the machine-readable
  1130. * name of the theme that will be used to render the page. If not provided,
  1131. * the value will be inherited from a parent menu item. If there is no
  1132. * theme callback, or if the function does not return the name of a current
  1133. * active theme on the site, the theme for this page will be determined by
  1134. * either hook_custom_theme() or the default theme instead. As a general
  1135. * rule, the use of theme callback functions should be limited to pages
  1136. * whose functionality is very closely tied to a particular theme, since
  1137. * they can only be overridden by modules which specifically target those
  1138. * pages in hook_menu_alter(). Modules implementing more generic theme
  1139. * switching functionality (for example, a module which allows the theme to
  1140. * be set dynamically based on the current user's role) should use
  1141. * hook_custom_theme() instead.
  1142. * - "theme arguments": An array of arguments to pass to the theme callback
  1143. * function, with path component substitution as described above.
  1144. * - "file": A file that will be included before the page callback is called;
  1145. * this allows page callback functions to be in separate files. The file
  1146. * should be relative to the implementing module's directory unless
  1147. * otherwise specified by the "file path" option. Does not apply to other
  1148. * callbacks (only page callback).
  1149. * - "file path": The path to the directory containing the file specified in
  1150. * "file". This defaults to the path to the module implementing the hook.
  1151. * - "load arguments": An array of arguments to be passed to each of the
  1152. * wildcard object loaders in the path, after the path argument itself.
  1153. * For example, if a module registers path node/%node/revisions/%/view
  1154. * with load arguments set to array(3), the '%node' in the path indicates
  1155. * that the loader function node_load() will be called with the second
  1156. * path component as the first argument. The 3 in the load arguments
  1157. * indicates that the fourth path component will also be passed to
  1158. * node_load() (numbering of path components starts at zero). So, if path
  1159. * node/12/revisions/29/view is requested, node_load(12, 29) will be called.
  1160. * There are also two "magic" values that can be used in load arguments.
  1161. * "%index" indicates the index of the wildcard path component. "%map"
  1162. * indicates the path components as an array. For example, if a module
  1163. * registers for several paths of the form 'user/%user_category/edit/*', all
  1164. * of them can use the same load function user_category_load(), by setting
  1165. * the load arguments to array('%map', '%index'). For instance, if the user
  1166. * is editing category 'foo' by requesting path 'user/32/edit/foo', the load
  1167. * function user_category_load() will be called with 32 as its first
  1168. * argument, the array ('user', 32, 'edit', 'foo') as the map argument,
  1169. * and 1 as the index argument (because %user_category is the second path
  1170. * component and numbering starts at zero). user_category_load() can then
  1171. * use these values to extract the information that 'foo' is the category
  1172. * being requested.
  1173. * - "weight": An integer that determines the relative position of items in
  1174. * the menu; higher-weighted items sink. Defaults to 0. Menu items with the
  1175. * same weight are ordered alphabetically.
  1176. * - "menu_name": Optional. Set this to a custom menu if you don't want your
  1177. * item to be placed in Navigation.
  1178. * - "expanded": Optional. If set to TRUE, and if a menu link is provided for
  1179. * this menu item (as a result of other properties), then the menu link is
  1180. * always expanded, equivalent to its 'always expanded' checkbox being set
  1181. * in the UI.
  1182. * - "context": (optional) Defines the context a tab may appear in. By
  1183. * default, all tabs are only displayed as local tasks when being rendered
  1184. * in a page context. All tabs that should be accessible as contextual links
  1185. * in page region containers outside of the parent menu item's primary page
  1186. * context should be registered using one of the following contexts:
  1187. * - MENU_CONTEXT_PAGE: (default) The tab is displayed as local task for the
  1188. * page context only.
  1189. * - MENU_CONTEXT_INLINE: The tab is displayed as contextual link outside of
  1190. * the primary page context only.
  1191. * Contexts can be combined. For example, to display a tab both on a page
  1192. * and inline, a menu router item may specify:
  1193. * @code
  1194. * 'context' => MENU_CONTEXT_PAGE | MENU_CONTEXT_INLINE,
  1195. * @endcode
  1196. * - "tab_parent": For local task menu items, the path of the task's parent
  1197. * item; defaults to the same path without the last component (e.g., the
  1198. * default parent for 'admin/people/create' is 'admin/people').
  1199. * - "tab_root": For local task menu items, the path of the closest non-tab
  1200. * item; same default as "tab_parent".
  1201. * - "position": Position of the block ('left' or 'right') on the system
  1202. * administration page for this item.
  1203. * - "type": A bitmask of flags describing properties of the menu item.
  1204. * Many shortcut bitmasks are provided as constants in menu.inc:
  1205. * - MENU_NORMAL_ITEM: Normal menu items show up in the menu tree and can be
  1206. * moved/hidden by the administrator.
  1207. * - MENU_CALLBACK: Callbacks simply register a path so that the correct
  1208. * information is generated when the path is accessed.
  1209. * - MENU_SUGGESTED_ITEM: Modules may "suggest" menu items that the
  1210. * administrator may enable.
  1211. * - MENU_LOCAL_ACTION: Local actions are menu items that describe actions
  1212. * on the parent item such as adding a new user or block, and are
  1213. * rendered in the action-links list in your theme.
  1214. * - MENU_LOCAL_TASK: Local tasks are menu items that describe different
  1215. * displays of data, and are generally rendered as tabs.
  1216. * - MENU_DEFAULT_LOCAL_TASK: Every set of local tasks should provide one
  1217. * "default" task, which should display the same page as the parent item.
  1218. * If the "type" element is omitted, MENU_NORMAL_ITEM is assumed.
  1219. * - "options": An array of options to be passed to l() when generating a link
  1220. * from this menu item. Note that the "options" parameter has no effect on
  1221. * MENU_LOCAL_TASK, MENU_DEFAULT_LOCAL_TASK, and MENU_LOCAL_ACTION items.
  1222. *
  1223. * For a detailed usage example, see page_example.module.
  1224. * For comprehensive documentation on the menu system, see
  1225. * http://drupal.org/node/102338.
  1226. */
  1227. function hook_menu() {
  1228. $items['example'] = array(
  1229. 'title' => 'Example Page',
  1230. 'page callback' => 'example_page',
  1231. 'access arguments' => array('access content'),
  1232. 'type' => MENU_SUGGESTED_ITEM,
  1233. );
  1234. $items['example/feed'] = array(
  1235. 'title' => 'Example RSS feed',
  1236. 'page callback' => 'example_feed',
  1237. 'access arguments' => array('access content'),
  1238. 'type' => MENU_CALLBACK,
  1239. );
  1240. return $items;
  1241. }
  1242. /**
  1243. * Alter the data being saved to the {menu_router} table after hook_menu is invoked.
  1244. *
  1245. * This hook is invoked by menu_router_build(). The menu definitions are passed
  1246. * in by reference. Each element of the $items array is one item returned
  1247. * by a module from hook_menu. Additional items may be added, or existing items
  1248. * altered.
  1249. *
  1250. * @param $items
  1251. * Associative array of menu router definitions returned from hook_menu().
  1252. */
  1253. function hook_menu_alter(&$items) {
  1254. // Example - disable the page at node/add
  1255. $items['node/add']['access callback'] = FALSE;
  1256. }
  1257. /**
  1258. * Alter the data being saved to the {menu_links} table by menu_link_save().
  1259. *
  1260. * @param $item
  1261. * Associative array defining a menu link as passed into menu_link_save().
  1262. *
  1263. * @see hook_translated_menu_link_alter()
  1264. */
  1265. function hook_menu_link_alter(&$item) {
  1266. // Make all new admin links hidden (a.k.a disabled).
  1267. if (strpos($item['link_path'], 'admin') === 0 && empty($item['mlid'])) {
  1268. $item['hidden'] = 1;
  1269. }
  1270. // Flag a link to be altered by hook_translated_menu_link_alter().
  1271. if ($item['link_path'] == 'devel/cache/clear') {
  1272. $item['options']['alter'] = TRUE;
  1273. }
  1274. // Flag a link to be altered by hook_translated_menu_link_alter(), but only
  1275. // if it is derived from a menu router item; i.e., do not alter a custom
  1276. // menu link pointing to the same path that has been created by a user.
  1277. if ($item['link_path'] == 'user' && $item['module'] == 'system') {
  1278. $item['options']['alter'] = TRUE;
  1279. }
  1280. }
  1281. /**
  1282. * Alter a menu link after it has been translated and before it is rendered.
  1283. *
  1284. * This hook is invoked from _menu_link_translate() after a menu link has been
  1285. * translated; i.e., after dynamic path argument placeholders (%) have been
  1286. * replaced with actual values, the user access to the link's target page has
  1287. * been checked, and the link has been localized. It is only invoked if
  1288. * $item['options']['alter'] has been set to a non-empty value (e.g., TRUE).
  1289. * This flag should be set using hook_menu_link_alter().
  1290. *
  1291. * Implementations of this hook are able to alter any property of the menu link.
  1292. * For example, this hook may be used to add a page-specific query string to all
  1293. * menu links, or hide a certain link by setting:
  1294. * @code
  1295. * 'hidden' => 1,
  1296. * @endcode
  1297. *
  1298. * @param $item
  1299. * Associative array defining a menu link after _menu_link_translate()
  1300. * @param $map
  1301. * Associative array containing the menu $map (path parts and/or objects).
  1302. *
  1303. * @see hook_menu_link_alter()
  1304. */
  1305. function hook_translated_menu_link_alter(&$item, $map) {
  1306. if ($item['href'] == 'devel/cache/clear') {
  1307. $item['localized_options']['query'] = drupal_get_destination();
  1308. }
  1309. }
  1310. /**
  1311. * Inform modules that a menu link has been created.
  1312. *
  1313. * This hook is used to notify modules that menu items have been
  1314. * created. Contributed modules may use the information to perform
  1315. * actions based on the information entered into the menu system.
  1316. *
  1317. * @param $link
  1318. * Associative array defining a menu link as passed into menu_link_save().
  1319. *
  1320. * @see hook_menu_link_update()
  1321. * @see hook_menu_link_delete()
  1322. */
  1323. function hook_menu_link_insert($link) {
  1324. // In our sample case, we track menu items as editing sections
  1325. // of the site. These are stored in our table as 'disabled' items.
  1326. $record['mlid'] = $link['mlid'];
  1327. $record['menu_name'] = $link['menu_name'];
  1328. $record['status'] = 0;
  1329. drupal_write_record('menu_example', $record);
  1330. }
  1331. /**
  1332. * Inform modules that a menu link has been updated.
  1333. *
  1334. * This hook is used to notify modules that menu items have been
  1335. * updated. Contributed modules may use the information to perform
  1336. * actions based on the information entered into the menu system.
  1337. *
  1338. * @param $link
  1339. * Associative array defining a menu link as passed into menu_link_save().
  1340. *
  1341. * @see hook_menu_link_insert()
  1342. * @see hook_menu_link_delete()
  1343. */
  1344. function hook_menu_link_update($link) {
  1345. // If the parent menu has changed, update our record.
  1346. $menu_name = db_query("SELECT menu_name FROM {menu_example} WHERE mlid = :mlid", array(':mlid' => $link['mlid']))->fetchField();
  1347. if ($menu_name != $link['menu_name']) {
  1348. db_update('menu_example')
  1349. ->fields(array('menu_name' => $link['menu_name']))
  1350. ->condition('mlid', $link['mlid'])
  1351. ->execute();
  1352. }
  1353. }
  1354. /**
  1355. * Inform modules that a menu link has been deleted.
  1356. *
  1357. * This hook is used to notify modules that menu items have been
  1358. * deleted. Contributed modules may use the information to perform
  1359. * actions based on the information entered into the menu system.
  1360. *
  1361. * @param $link
  1362. * Associative array defining a menu link as passed into menu_link_save().
  1363. *
  1364. * @see hook_menu_link_insert()
  1365. * @see hook_menu_link_update()
  1366. */
  1367. function hook_menu_link_delete($link) {
  1368. // Delete the record from our table.
  1369. db_delete('menu_example')
  1370. ->condition('mlid', $link['mlid'])
  1371. ->execute();
  1372. }
  1373. /**
  1374. * Alter tabs and actions displayed on the page before they are rendered.
  1375. *
  1376. * This hook is invoked by menu_local_tasks(). The system-determined tabs and
  1377. * actions are passed in by reference. Additional tabs or actions may be added,
  1378. * or existing items altered.
  1379. *
  1380. * Each tab or action is an associative array containing:
  1381. * - #theme: The theme function to use to render.
  1382. * - #link: An associative array containing:
  1383. * - title: The localized title of the link.
  1384. * - href: The system path to link to.
  1385. * - localized_options: An array of options to pass to l().
  1386. * - #active: Whether the link should be marked as 'active'.
  1387. *
  1388. * @param $data
  1389. * An associative array containing:
  1390. * - actions: An associative array containing:
  1391. * - count: The amount of actions determined by the menu system, which can
  1392. * be ignored.
  1393. * - output: A list of of actions, each one being an associative array
  1394. * as described above.
  1395. * - tabs: An indexed array (list) of tab levels (up to 2 levels), each
  1396. * containing an associative array:
  1397. * - count: The amount of tabs determined by the menu system. This value
  1398. * does not need to be altered if there is more than one tab.
  1399. * - output: A list of of tabs, each one being an associative array as
  1400. * described above.
  1401. * @param $router_item
  1402. * The menu system router item of the page.
  1403. * @param $root_path
  1404. * The path to the root item for this set of tabs.
  1405. */
  1406. function hook_menu_local_tasks_alter(&$data, $router_item, $root_path) {
  1407. // Add an action linking to node/add to all pages.
  1408. $data['actions']['output'][] = array(
  1409. '#theme' => 'menu_local_task',
  1410. '#link' => array(
  1411. 'title' => t('Add new content'),
  1412. 'href' => 'node/add',
  1413. 'localized_options' => array(
  1414. 'attributes' => array(
  1415. 'title' => t('Add new content'),
  1416. ),
  1417. ),
  1418. ),
  1419. );
  1420. // Add a tab linking to node/add to all pages.
  1421. $data['tabs'][0]['output'][] = array(
  1422. '#theme' => 'menu_local_task',
  1423. '#link' => array(
  1424. 'title' => t('Example tab'),
  1425. 'href' => 'node/add',
  1426. 'localized_options' => array(
  1427. 'attributes' => array(
  1428. 'title' => t('Add new content'),
  1429. ),
  1430. ),
  1431. ),
  1432. // Define whether this link is active. This can be omitted for
  1433. // implementations that add links to pages outside of the current page
  1434. // context.
  1435. '#active' => ($router_item['path'] == $root_path),
  1436. );
  1437. }
  1438. /**
  1439. * Alter links in the active trail before it is rendered as the breadcrumb.
  1440. *
  1441. * This hook is invoked by menu_get_active_breadcrumb() and allows alteration
  1442. * of the breadcrumb links for the current page, which may be preferred instead
  1443. * of setting a custom breadcrumb via drupal_set_breadcrumb().
  1444. *
  1445. * Implementations should take into account that menu_get_active_breadcrumb()
  1446. * subsequently performs the following adjustments to the active trail *after*
  1447. * this hook has been invoked:
  1448. * - The last link in $active_trail is removed, if its 'href' is identical to
  1449. * the 'href' of $item. This happens, because the breadcrumb normally does
  1450. * not contain a link to the current page.
  1451. * - The (second to) last link in $active_trail is removed, if the current $item
  1452. * is a MENU_DEFAULT_LOCAL_TASK. This happens in order to do not show a link
  1453. * to the current page, when being on the path for the default local task;
  1454. * e.g. when being on the path node/%/view, the breadcrumb should not contain
  1455. * a link to node/%.
  1456. *
  1457. * Each link in the active trail must contain:
  1458. * - title: The localized title of the link.
  1459. * - href: The system path to link to.
  1460. * - localized_options: An array of options to pass to url().
  1461. *
  1462. * @param $active_trail
  1463. * An array containing breadcrumb links for the current page.
  1464. * @param $item
  1465. * The menu router item of the current page.
  1466. *
  1467. * @see drupal_set_breadcrumb()
  1468. * @see menu_get_active_breadcrumb()
  1469. * @see menu_get_active_trail()
  1470. * @see menu_set_active_trail()
  1471. */
  1472. function hook_menu_breadcrumb_alter(&$active_trail, $item) {
  1473. // Always display a link to the current page by duplicating the last link in
  1474. // the active trail. This means that menu_get_active_breadcrumb() will remove
  1475. // the last link (for the current page), but since it is added once more here,
  1476. // it will appear.
  1477. if (!drupal_is_front_page()) {
  1478. $end = end($active_trail);
  1479. if ($item['href'] == $end['href']) {
  1480. $active_trail[] = $end;
  1481. }
  1482. }
  1483. }
  1484. /**
  1485. * Alter contextual links before they are rendered.
  1486. *
  1487. * This hook is invoked by menu_contextual_links(). The system-determined
  1488. * contextual links are passed in by reference. Additional links may be added
  1489. * or existing links can be altered.
  1490. *
  1491. * Each contextual link must at least contain:
  1492. * - title: The localized title of the link.
  1493. * - href: The system path to link to.
  1494. * - localized_options: An array of options to pass to url().
  1495. *
  1496. * @param $links
  1497. * An associative array containing contextual links for the given $root_path,
  1498. * as described above. The array keys are used to build CSS class names for
  1499. * contextual links and must therefore be unique for each set of contextual
  1500. * links.
  1501. * @param $router_item
  1502. * The menu router item belonging to the $root_path being requested.
  1503. * @param $root_path
  1504. * The (parent) path that has been requested to build contextual links for.
  1505. * This is a normalized path, which means that an originally passed path of
  1506. * 'node/123' became 'node/%'.
  1507. *
  1508. * @see hook_contextual_links_view_alter()
  1509. * @see menu_contextual_links()
  1510. * @see hook_menu()
  1511. * @see contextual_preprocess()
  1512. */
  1513. function hook_menu_contextual_links_alter(&$links, $router_item, $root_path) {
  1514. // Add a link to all contextual links for nodes.
  1515. if ($root_path == 'node/%') {
  1516. $links['foo'] = array(
  1517. 'title' => t('Do fu'),
  1518. 'href' => 'foo/do',
  1519. 'localized_options' => array(
  1520. 'query' => array(
  1521. 'foo' => 'bar',
  1522. ),
  1523. ),
  1524. );
  1525. }
  1526. }
  1527. /**
  1528. * Perform alterations before a page is rendered.
  1529. *
  1530. * Use this hook when you want to remove or alter elements at the page
  1531. * level, or add elements at the page level that depend on an other module's
  1532. * elements (this hook runs after hook_page_build().
  1533. *
  1534. * If you are making changes to entities such as forms, menus, or user
  1535. * profiles, use those objects' native alter hooks instead (hook_form_alter(),
  1536. * for example).
  1537. *
  1538. * The $page array contains top level elements for each block region:
  1539. * @code
  1540. * $page['page_top']
  1541. * $page['header']
  1542. * $page['sidebar_first']
  1543. * $page['content']
  1544. * $page['sidebar_second']
  1545. * $page['page_bottom']
  1546. * @endcode
  1547. *
  1548. * The 'content' element contains the main content of the current page, and its
  1549. * structure will vary depending on what module is responsible for building the
  1550. * page. Some legacy modules may not return structured content at all: their
  1551. * pre-rendered markup will be located in $page['content']['main']['#markup'].
  1552. *
  1553. * Pages built by Drupal's core Node and Blog modules use a standard structure:
  1554. *
  1555. * @code
  1556. * // Node body.
  1557. * $page['content']['system_main']['nodes'][$nid]['body']
  1558. * // Array of links attached to the node (add comments, read more).
  1559. * $page['content']['system_main']['nodes'][$nid]['links']
  1560. * // The node object itself.
  1561. * $page['content']['system_main']['nodes'][$nid]['#node']
  1562. * // The results pager.
  1563. * $page['content']['system_main']['pager']
  1564. * @endcode
  1565. *
  1566. * Blocks may be referenced by their module/delta pair within a region:
  1567. * @code
  1568. * // The login block in the first sidebar region.
  1569. * $page['sidebar_first']['user_login']['#block'];
  1570. * @endcode
  1571. *
  1572. * @param $page
  1573. * Nested array of renderable elements that make up the page.
  1574. *
  1575. * @see hook_page_build()
  1576. * @see drupal_render_page()
  1577. */
  1578. function hook_page_alter(&$page) {
  1579. // Add help text to the user login block.
  1580. $page['sidebar_first']['user_login']['help'] = array(
  1581. '#weight' => -10,
  1582. '#markup' => t('To post comments or add new content, you first have to log in.'),
  1583. );
  1584. }
  1585. /**
  1586. * Perform alterations before a form is rendered.
  1587. *
  1588. * One popular use of this hook is to add form elements to the node form. When
  1589. * altering a node form, the node object can be accessed at $form['#node'].
  1590. *
  1591. * In addition to hook_form_alter(), which is called for all forms, there are
  1592. * two more specific form hooks available. The first,
  1593. * hook_form_BASE_FORM_ID_alter(), allows targeting of a form/forms via a base
  1594. * form (if one exists). The second, hook_form_FORM_ID_alter(), can be used to
  1595. * target a specific form directly.
  1596. *
  1597. * The call order is as follows: all existing form alter functions are called
  1598. * for module A, then all for module B, etc., followed by all for any base
  1599. * theme(s), and finally for the theme itself. The module order is determined
  1600. * by system weight, then by module name.
  1601. *
  1602. * Within each module, form alter hooks are called in the following order:
  1603. * first, hook_form_alter(); second, hook_form_BASE_FORM_ID_alter(); third,
  1604. * hook_form_FORM_ID_alter(). So, for each module, the more general hooks are
  1605. * called first followed by the more specific.
  1606. *
  1607. * @param $form
  1608. * Nested array of form elements that comprise the form.
  1609. * @param $form_state
  1610. * A keyed array containing the current state of the form. The arguments
  1611. * that drupal_get_form() was originally called with are available in the
  1612. * array $form_state['build_info']['args'].
  1613. * @param $form_id
  1614. * String representing the name of the form itself. Typically this is the
  1615. * name of the function that generated the form.
  1616. *
  1617. * @see hook_form_BASE_FORM_ID_alter()
  1618. * @see hook_form_FORM_ID_alter()
  1619. * @see forms_api_reference.html
  1620. */
  1621. function hook_form_alter(&$form, &$form_state, $form_id) {
  1622. if (isset($form['type']) && $form['type']['#value'] . '_node_settings' == $form_id) {
  1623. $form['workflow']['upload_' . $form['type']['#value']] = array(
  1624. '#type' => 'radios',
  1625. '#title' => t('Attachments'),
  1626. '#default_value' => variable_get('upload_' . $form['type']['#value'], 1),
  1627. '#options' => array(t('Disabled'), t('Enabled')),
  1628. );
  1629. }
  1630. }
  1631. /**
  1632. * Provide a form-specific alteration instead of the global hook_form_alter().
  1633. *
  1634. * Modules can implement hook_form_FORM_ID_alter() to modify a specific form,
  1635. * rather than implementing hook_form_alter() and checking the form ID, or
  1636. * using long switch statements to alter multiple forms.
  1637. *
  1638. * Form alter hooks are called in the following order: hook_form_alter(),
  1639. * hook_form_BASE_FORM_ID_alter(), hook_form_FORM_ID_alter(). See
  1640. * hook_form_alter() for more details.
  1641. *
  1642. * @param $form
  1643. * Nested array of form elements that comprise the form.
  1644. * @param $form_state
  1645. * A keyed array containing the current state of the form. The arguments
  1646. * that drupal_get_form() was originally called with are available in the
  1647. * array $form_state['build_info']['args'].
  1648. * @param $form_id
  1649. * String representing the name of the form itself. Typically this is the
  1650. * name of the function that generated the form.
  1651. *
  1652. * @see hook_form_alter()
  1653. * @see hook_form_BASE_FORM_ID_alter()
  1654. * @see drupal_prepare_form()
  1655. * @see forms_api_reference.html
  1656. */
  1657. function hook_form_FORM_ID_alter(&$form, &$form_state, $form_id) {
  1658. // Modification for the form with the given form ID goes here. For example, if
  1659. // FORM_ID is "user_register_form" this code would run only on the user
  1660. // registration form.
  1661. // Add a checkbox to registration form about agreeing to terms of use.
  1662. $form['terms_of_use'] = array(
  1663. '#type' => 'checkbox',
  1664. '#title' => t("I agree with the website's terms and conditions."),
  1665. '#required' => TRUE,
  1666. );
  1667. }
  1668. /**
  1669. * Provide a form-specific alteration for shared ('base') forms.
  1670. *
  1671. * By default, when drupal_get_form() is called, Drupal looks for a function
  1672. * with the same name as the form ID, and uses that function to build the form.
  1673. * In contrast, base forms allow multiple form IDs to be mapped to a single base
  1674. * (also called 'factory') form function.
  1675. *
  1676. * Modules can implement hook_form_BASE_FORM_ID_alter() to modify a specific
  1677. * base form, rather than implementing hook_form_alter() and checking for
  1678. * conditions that would identify the shared form constructor.
  1679. *
  1680. * To identify the base form ID for a particular form (or to determine whether
  1681. * one exists) check the $form_state. The base form ID is stored under
  1682. * $form_state['build_info']['base_form_id'].
  1683. *
  1684. * See hook_forms() for more information on how to implement base forms in
  1685. * Drupal.
  1686. *
  1687. * Form alter hooks are called in the following order: hook_form_alter(),
  1688. * hook_form_BASE_FORM_ID_alter(), hook_form_FORM_ID_alter(). See
  1689. * hook_form_alter() for more details.
  1690. *
  1691. * @param $form
  1692. * Nested array of form elements that comprise the form.
  1693. * @param $form_state
  1694. * A keyed array containing the current state of the form.
  1695. * @param $form_id
  1696. * String representing the name of the form itself. Typically this is the
  1697. * name of the function that generated the form.
  1698. *
  1699. * @see hook_form_alter()
  1700. * @see hook_form_FORM_ID_alter()
  1701. * @see drupal_prepare_form()
  1702. * @see hook_forms()
  1703. */
  1704. function hook_form_BASE_FORM_ID_alter(&$form, &$form_state, $form_id) {
  1705. // Modification for the form with the given BASE_FORM_ID goes here. For
  1706. // example, if BASE_FORM_ID is "node_form", this code would run on every
  1707. // node form, regardless of node type.
  1708. // Add a checkbox to the node form about agreeing to terms of use.
  1709. $form['terms_of_use'] = array(
  1710. '#type' => 'checkbox',
  1711. '#title' => t("I agree with the website's terms and conditions."),
  1712. '#required' => TRUE,
  1713. );
  1714. }
  1715. /**
  1716. * Map form_ids to form builder functions.
  1717. *
  1718. * By default, when drupal_get_form() is called, the system will look for a
  1719. * function with the same name as the form ID, and use that function to build
  1720. * the form. If no such function is found, Drupal calls this hook. Modules
  1721. * implementing this hook can then provide their own instructions for mapping
  1722. * form IDs to constructor functions. As a result, you can easily map multiple
  1723. * form IDs to a single form constructor (referred to as a 'base' form).
  1724. *
  1725. * Using a base form can help to avoid code duplication, by allowing many
  1726. * similar forms to use the same code base. Another benefit is that it becomes
  1727. * much easier for other modules to apply a general change to the group of
  1728. * forms; hook_form_BASE_FORM_ID_alter() can be used to easily alter multiple
  1729. * forms at once by directly targeting the shared base form.
  1730. *
  1731. * Two example use cases where base forms may be useful are given below.
  1732. *
  1733. * First, you can use this hook to tell the form system to use a different
  1734. * function to build certain forms in your module; this is often used to define
  1735. * a form "factory" function that is used to build several similar forms. In
  1736. * this case, your hook implementation will likely ignore all of the input
  1737. * arguments. See node_forms() for an example of this. Note, node_forms() is the
  1738. * hook_forms() implementation; the base form itself is defined in node_form().
  1739. *
  1740. * Second, you could use this hook to define how to build a form with a
  1741. * dynamically-generated form ID. In this case, you would need to verify that
  1742. * the $form_id input matched your module's format for dynamically-generated
  1743. * form IDs, and if so, act appropriately.
  1744. *
  1745. * Third, forms defined in classes can be defined this way.
  1746. *
  1747. * @param $form_id
  1748. * The unique string identifying the desired form.
  1749. * @param $args
  1750. * An array containing the original arguments provided to drupal_get_form()
  1751. * or drupal_form_submit(). These are always passed to the form builder and
  1752. * do not have to be specified manually in 'callback arguments'.
  1753. *
  1754. * @return
  1755. * An associative array whose keys define form_ids and whose values are an
  1756. * associative array defining the following keys:
  1757. * - callback: The callable returning the form array. If it is the name of
  1758. * the form builder function then this will be used for the base
  1759. * form ID, for example, to target a base form using
  1760. * hook_form_BASE_FORM_ID_alter(). Otherwise use the base_form_id key to
  1761. * define the base form ID.
  1762. * - callback arguments: (optional) Additional arguments to pass to the
  1763. * function defined in 'callback', which are prepended to $args.
  1764. * - base_form_id: The base form ID can be specified explicitly. This is
  1765. * required when callback is not the name of a function.
  1766. * - wrapper_callback: (optional) Any callable to invoke before the form
  1767. * builder defined in 'callback' is invoked. This wrapper callback may
  1768. * prepopulate the $form array with form elements, which will then be
  1769. * already contained in the $form that is passed on to the form builder
  1770. * defined in 'callback'. For example, a wrapper callback could setup
  1771. * wizard-like form buttons that are the same for a variety of forms that
  1772. * belong to the wizard, which all share the same wrapper callback.
  1773. */
  1774. function hook_forms($form_id, $args) {
  1775. // Simply reroute the (non-existing) $form_id 'mymodule_first_form' to
  1776. // 'mymodule_main_form'.
  1777. $forms['mymodule_first_form'] = array(
  1778. 'callback' => 'mymodule_main_form',
  1779. );
  1780. // Reroute the $form_id and prepend an additional argument that gets passed to
  1781. // the 'mymodule_main_form' form builder function.
  1782. $forms['mymodule_second_form'] = array(
  1783. 'callback' => 'mymodule_main_form',
  1784. 'callback arguments' => array('some parameter'),
  1785. );
  1786. // Reroute the $form_id, but invoke the form builder function
  1787. // 'mymodule_main_form_wrapper' first, so we can prepopulate the $form array
  1788. // that is passed to the actual form builder 'mymodule_main_form'.
  1789. $forms['mymodule_wrapped_form'] = array(
  1790. 'callback' => 'mymodule_main_form',
  1791. 'wrapper_callback' => 'mymodule_main_form_wrapper',
  1792. );
  1793. // Build a form with a static class callback.
  1794. $forms['mymodule_class_generated_form'] = array(
  1795. // This will call: MyClass::generateMainForm().
  1796. 'callback' => array('MyClass', 'generateMainForm'),
  1797. // The base_form_id is required when the callback is a static function in
  1798. // a class. This can also be used to keep newer code backwards compatible.
  1799. 'base_form_id' => 'mymodule_main_form',
  1800. );
  1801. return $forms;
  1802. }
  1803. /**
  1804. * Perform setup tasks for all page requests.
  1805. *
  1806. * This hook is run at the beginning of the page request. It is typically
  1807. * used to set up global parameters that are needed later in the request.
  1808. *
  1809. * Only use this hook if your code must run even for cached page views. This
  1810. * hook is called before the theme, modules, or most include files are loaded
  1811. * into memory. It happens while Drupal is still in bootstrap mode.
  1812. *
  1813. * @see hook_init()
  1814. */
  1815. function hook_boot() {
  1816. // We need user_access() in the shutdown function. Make sure it gets loaded.
  1817. drupal_load('module', 'user');
  1818. drupal_register_shutdown_function('devel_shutdown');
  1819. }
  1820. /**
  1821. * Perform setup tasks for non-cached page requests.
  1822. *
  1823. * This hook is run at the beginning of the page request. It is typically
  1824. * used to set up global parameters that are needed later in the request.
  1825. * When this hook is called, the theme and all modules are already loaded in
  1826. * memory.
  1827. *
  1828. * This hook is not run on cached pages.
  1829. *
  1830. * To add CSS or JS that should be present on all pages, modules should not
  1831. * implement this hook, but declare these files in their .info file.
  1832. *
  1833. * @see hook_boot()
  1834. */
  1835. function hook_init() {
  1836. // Since this file should only be loaded on the front page, it cannot be
  1837. // declared in the info file.
  1838. if (drupal_is_front_page()) {
  1839. drupal_add_css(drupal_get_path('module', 'foo') . '/foo.css');
  1840. }
  1841. }
  1842. /**
  1843. * Define image toolkits provided by this module.
  1844. *
  1845. * The file which includes each toolkit's functions must be included in this
  1846. * hook.
  1847. *
  1848. * The toolkit's functions must be named image_toolkitname_operation().
  1849. * where the operation may be:
  1850. * - 'load': Required. See image_gd_load() for usage.
  1851. * - 'save': Required. See image_gd_save() for usage.
  1852. * - 'settings': Optional. See image_gd_settings() for usage.
  1853. * - 'resize': Optional. See image_gd_resize() for usage.
  1854. * - 'rotate': Optional. See image_gd_rotate() for usage.
  1855. * - 'crop': Optional. See image_gd_crop() for usage.
  1856. * - 'desaturate': Optional. See image_gd_desaturate() for usage.
  1857. *
  1858. * @return
  1859. * An array with the toolkit name as keys and sub-arrays with these keys:
  1860. * - 'title': A string with the toolkit's title.
  1861. * - 'available': A Boolean value to indicate that the toolkit is operating
  1862. * properly, e.g. all required libraries exist.
  1863. *
  1864. * @see system_image_toolkits()
  1865. */
  1866. function hook_image_toolkits() {
  1867. return array(
  1868. 'working' => array(
  1869. 'title' => t('A toolkit that works.'),
  1870. 'available' => TRUE,
  1871. ),
  1872. 'broken' => array(
  1873. 'title' => t('A toolkit that is "broken" and will not be listed.'),
  1874. 'available' => FALSE,
  1875. ),
  1876. );
  1877. }
  1878. /**
  1879. * Alter an email message created with the drupal_mail() function.
  1880. *
  1881. * hook_mail_alter() allows modification of email messages created and sent
  1882. * with drupal_mail(). Usage examples include adding and/or changing message
  1883. * text, message fields, and message headers.
  1884. *
  1885. * Email messages sent using functions other than drupal_mail() will not
  1886. * invoke hook_mail_alter(). For example, a contributed module directly
  1887. * calling the drupal_mail_system()->mail() or PHP mail() function
  1888. * will not invoke this hook. All core modules use drupal_mail() for
  1889. * messaging, it is best practice but not mandatory in contributed modules.
  1890. *
  1891. * @param $message
  1892. * An array containing the message data. Keys in this array include:
  1893. * - 'id':
  1894. * The drupal_mail() id of the message. Look at module source code or
  1895. * drupal_mail() for possible id values.
  1896. * - 'to':
  1897. * The address or addresses the message will be sent to. The formatting of
  1898. * this string will be validated with the
  1899. * @link http://php.net/manual/filter.filters.validate.php PHP e-mail validation filter. @endlink
  1900. * - 'from':
  1901. * The address the message will be marked as being from, which is
  1902. * either a custom address or the site-wide default email address.
  1903. * - 'subject':
  1904. * Subject of the email to be sent. This must not contain any newline
  1905. * characters, or the email may not be sent properly.
  1906. * - 'body':
  1907. * An array of strings containing the message text. The message body is
  1908. * created by concatenating the individual array strings into a single text
  1909. * string using "\n\n" as a separator.
  1910. * - 'headers':
  1911. * Associative array containing mail headers, such as From, Sender,
  1912. * MIME-Version, Content-Type, etc.
  1913. * - 'params':
  1914. * An array of optional parameters supplied by the caller of drupal_mail()
  1915. * that is used to build the message before hook_mail_alter() is invoked.
  1916. * - 'language':
  1917. * The language object used to build the message before hook_mail_alter()
  1918. * is invoked.
  1919. * - 'send':
  1920. * Set to FALSE to abort sending this email message.
  1921. *
  1922. * @see drupal_mail()
  1923. */
  1924. function hook_mail_alter(&$message) {
  1925. if ($message['id'] == 'modulename_messagekey') {
  1926. if (!example_notifications_optin($message['to'], $message['id'])) {
  1927. // If the recipient has opted to not receive such messages, cancel
  1928. // sending.
  1929. $message['send'] = FALSE;
  1930. return;
  1931. }
  1932. $message['body'][] = "--\nMail sent out from " . variable_get('site_name', t('Drupal'));
  1933. }
  1934. }
  1935. /**
  1936. * Alter the registry of modules implementing a hook.
  1937. *
  1938. * This hook is invoked during module_implements(). A module may implement this
  1939. * hook in order to reorder the implementing modules, which are otherwise
  1940. * ordered by the module's system weight.
  1941. *
  1942. * Note that hooks invoked using drupal_alter() can have multiple variations
  1943. * (such as hook_form_alter() and hook_form_FORM_ID_alter()). drupal_alter()
  1944. * will call all such variants defined by a single module in turn. For the
  1945. * purposes of hook_module_implements_alter(), these variants are treated as
  1946. * a single hook. Thus, to ensure that your implementation of
  1947. * hook_form_FORM_ID_alter() is called at the right time, you will have to
  1948. * change the order of hook_form_alter() implementation in
  1949. * hook_module_implements_alter().
  1950. *
  1951. * @param $implementations
  1952. * An array keyed by the module's name. The value of each item corresponds
  1953. * to a $group, which is usually FALSE, unless the implementation is in a
  1954. * file named $module.$group.inc.
  1955. * @param $hook
  1956. * The name of the module hook being implemented.
  1957. */
  1958. function hook_module_implements_alter(&$implementations, $hook) {
  1959. if ($hook == 'rdf_mapping') {
  1960. // Move my_module_rdf_mapping() to the end of the list. module_implements()
  1961. // iterates through $implementations with a foreach loop which PHP iterates
  1962. // in the order that the items were added, so to move an item to the end of
  1963. // the array, we remove it and then add it.
  1964. $group = $implementations['my_module'];
  1965. unset($implementations['my_module']);
  1966. $implementations['my_module'] = $group;
  1967. }
  1968. }
  1969. /**
  1970. * Return additional themes provided by modules.
  1971. *
  1972. * Only use this hook for testing purposes. Use a hidden MYMODULE_test.module
  1973. * to implement this hook. Testing themes should be hidden, too.
  1974. *
  1975. * This hook is invoked from _system_rebuild_theme_data() and allows modules to
  1976. * register additional themes outside of the regular 'themes' directories of a
  1977. * Drupal installation.
  1978. *
  1979. * @return
  1980. * An associative array. Each key is the system name of a theme and each value
  1981. * is the corresponding path to the theme's .info file.
  1982. */
  1983. function hook_system_theme_info() {
  1984. $themes['mymodule_test_theme'] = drupal_get_path('module', 'mymodule') . '/mymodule_test_theme/mymodule_test_theme.info';
  1985. return $themes;
  1986. }
  1987. /**
  1988. * Alter the information parsed from module and theme .info files
  1989. *
  1990. * This hook is invoked in _system_rebuild_module_data() and in
  1991. * _system_rebuild_theme_data(). A module may implement this hook in order to
  1992. * add to or alter the data generated by reading the .info file with
  1993. * drupal_parse_info_file().
  1994. *
  1995. * @param $info
  1996. * The .info file contents, passed by reference so that it can be altered.
  1997. * @param $file
  1998. * Full information about the module or theme, including $file->name, and
  1999. * $file->filename
  2000. * @param $type
  2001. * Either 'module' or 'theme', depending on the type of .info file that was
  2002. * passed.
  2003. */
  2004. function hook_system_info_alter(&$info, $file, $type) {
  2005. // Only fill this in if the .info file does not define a 'datestamp'.
  2006. if (empty($info['datestamp'])) {
  2007. $info['datestamp'] = filemtime($file->filename);
  2008. }
  2009. }
  2010. /**
  2011. * Define user permissions.
  2012. *
  2013. * This hook can supply permissions that the module defines, so that they
  2014. * can be selected on the user permissions page and used to grant or restrict
  2015. * access to actions the module performs.
  2016. *
  2017. * Permissions are checked using user_access().
  2018. *
  2019. * For a detailed usage example, see page_example.module.
  2020. *
  2021. * @return
  2022. * An array whose keys are permission names and whose corresponding values
  2023. * are arrays containing the following key-value pairs:
  2024. * - title: The human-readable name of the permission, to be shown on the
  2025. * permission administration page. This should be wrapped in the t()
  2026. * function so it can be translated.
  2027. * - description: (optional) A description of what the permission does. This
  2028. * should be wrapped in the t() function so it can be translated.
  2029. * - restrict access: (optional) A boolean which can be set to TRUE to
  2030. * indicate that site administrators should restrict access to this
  2031. * permission to trusted users. This should be used for permissions that
  2032. * have inherent security risks across a variety of potential use cases
  2033. * (for example, the "administer filters" and "bypass node access"
  2034. * permissions provided by Drupal core). When set to TRUE, a standard
  2035. * warning message defined in user_admin_permissions() and output via
  2036. * theme_user_permission_description() will be associated with the
  2037. * permission and displayed with it on the permission administration page.
  2038. * Defaults to FALSE.
  2039. * - warning: (optional) A translated warning message to display for this
  2040. * permission on the permission administration page. This warning overrides
  2041. * the automatic warning generated by 'restrict access' being set to TRUE.
  2042. * This should rarely be used, since it is important for all permissions to
  2043. * have a clear, consistent security warning that is the same across the
  2044. * site. Use the 'description' key instead to provide any information that
  2045. * is specific to the permission you are defining.
  2046. *
  2047. * @see theme_user_permission_description()
  2048. */
  2049. function hook_permission() {
  2050. return array(
  2051. 'administer my module' => array(
  2052. 'title' => t('Administer my module'),
  2053. 'description' => t('Perform administration tasks for my module.'),
  2054. ),
  2055. );
  2056. }
  2057. /**
  2058. * Provide online user help.
  2059. *
  2060. * By implementing hook_help(), a module can make documentation available to
  2061. * the user for the module as a whole, or for specific paths. Help for
  2062. * developers should usually be provided via function header comments in the
  2063. * code, or in special API example files.
  2064. *
  2065. * The page-specific help information provided by this hook appears as a system
  2066. * help block on that page. The module overview help information is displayed
  2067. * by the Help module. It can be accessed from the page at admin/help or from
  2068. * the Modules page.
  2069. *
  2070. * For detailed usage examples of:
  2071. * - Module overview help, see node_help(). Module overview help should follow
  2072. * @link https://drupal.org/node/632280 the standard help template. @endlink
  2073. * - Page-specific help with simple paths, see dashboard_help().
  2074. * - Page-specific help using wildcards in path and $arg, see node_help()
  2075. * and block_help().
  2076. *
  2077. * @param $path
  2078. * The router menu path, as defined in hook_menu(), for the help that is
  2079. * being requested; e.g., 'admin/people' or 'user/register'. If the router
  2080. * path includes a wildcard, then this will appear in $path as %, even if it
  2081. * is a named %autoloader wildcard in the hook_menu() implementation; for
  2082. * example, node pages would have $path equal to 'node/%' or 'node/%/view'.
  2083. * For the help page for the module as a whole, $path will have the value
  2084. * 'admin/help#module_name', where 'module_name" is the machine name of your
  2085. * module.
  2086. * @param $arg
  2087. * An array that corresponds to the return value of the arg() function, for
  2088. * modules that want to provide help that is specific to certain values
  2089. * of wildcards in $path. For example, you could provide help for the path
  2090. * 'user/1' by looking for the path 'user/%' and $arg[1] == '1'. This given
  2091. * array should always be used rather than directly invoking arg(), because
  2092. * your hook implementation may be called for other purposes besides building
  2093. * the current page's help. Note that depending on which module is invoking
  2094. * hook_help, $arg may contain only empty strings. Regardless, $arg[0] to
  2095. * $arg[11] will always be set.
  2096. *
  2097. * @return
  2098. * A localized string containing the help text.
  2099. */
  2100. function hook_help($path, $arg) {
  2101. switch ($path) {
  2102. // Main module help for the block module
  2103. case 'admin/help#block':
  2104. return '<p>' . t('Blocks are boxes of content rendered into an area, or region, of a web page. The default theme Bartik, for example, implements the regions "Sidebar first", "Sidebar second", "Featured", "Content", "Header", "Footer", etc., and a block may appear in any one of these areas. The <a href="@blocks">blocks administration page</a> provides a drag-and-drop interface for assigning a block to a region, and for controlling the order of blocks within regions.', array('@blocks' => url('admin/structure/block'))) . '</p>';
  2105. // Help for another path in the block module
  2106. case 'admin/structure/block':
  2107. return '<p>' . t('This page provides a drag-and-drop interface for assigning a block to a region, and for controlling the order of blocks within regions. Since not all themes implement the same regions, or display regions in the same way, blocks are positioned on a per-theme basis. Remember that your changes will not be saved until you click the <em>Save blocks</em> button at the bottom of the page.') . '</p>';
  2108. }
  2109. }
  2110. /**
  2111. * Register a module (or theme's) theme implementations.
  2112. *
  2113. * The implementations declared by this hook have two purposes: either they
  2114. * specify how a particular render array is to be rendered as HTML (this is
  2115. * usually the case if the theme function is assigned to the render array's
  2116. * #theme property), or they return the HTML that should be returned by an
  2117. * invocation of theme(). See
  2118. * @link http://drupal.org/node/933976 Using the theme layer Drupal 7.x @endlink
  2119. * for more information on how to implement theme hooks.
  2120. *
  2121. * The following parameters are all optional.
  2122. *
  2123. * @param array $existing
  2124. * An array of existing implementations that may be used for override
  2125. * purposes. This is primarily useful for themes that may wish to examine
  2126. * existing implementations to extract data (such as arguments) so that
  2127. * it may properly register its own, higher priority implementations.
  2128. * @param $type
  2129. * Whether a theme, module, etc. is being processed. This is primarily useful
  2130. * so that themes tell if they are the actual theme being called or a parent
  2131. * theme. May be one of:
  2132. * - 'module': A module is being checked for theme implementations.
  2133. * - 'base_theme_engine': A theme engine is being checked for a theme that is
  2134. * a parent of the actual theme being used.
  2135. * - 'theme_engine': A theme engine is being checked for the actual theme
  2136. * being used.
  2137. * - 'base_theme': A base theme is being checked for theme implementations.
  2138. * - 'theme': The actual theme in use is being checked.
  2139. * @param $theme
  2140. * The actual name of theme, module, etc. that is being being processed.
  2141. * @param $path
  2142. * The directory path of the theme or module, so that it doesn't need to be
  2143. * looked up.
  2144. *
  2145. * @return array
  2146. * An associative array of theme hook information. The keys on the outer
  2147. * array are the internal names of the hooks, and the values are arrays
  2148. * containing information about the hook. Each information array must contain
  2149. * either a 'variables' element or a 'render element' element, but not both.
  2150. * Use 'render element' if you are theming a single element or element tree
  2151. * composed of elements, such as a form array, a page array, or a single
  2152. * checkbox element. Use 'variables' if your theme implementation is
  2153. * intended to be called directly through theme() and has multiple arguments
  2154. * for the data and style; in this case, the variables not supplied by the
  2155. * calling function will be given default values and passed to the template
  2156. * or theme function. The returned theme information array can contain the
  2157. * following key/value pairs:
  2158. * - variables: (see above) Each array key is the name of the variable, and
  2159. * the value given is used as the default value if the function calling
  2160. * theme() does not supply it. Template implementations receive each array
  2161. * key as a variable in the template file (so they must be legal PHP
  2162. * variable names). Function implementations are passed the variables in a
  2163. * single $variables function argument.
  2164. * - render element: (see above) The name of the renderable element or element
  2165. * tree to pass to the theme function. This name is used as the name of the
  2166. * variable that holds the renderable element or tree in preprocess and
  2167. * process functions.
  2168. * - file: The file the implementation resides in. This file will be included
  2169. * prior to the theme being rendered, to make sure that the function or
  2170. * preprocess function (as needed) is actually loaded; this makes it
  2171. * possible to split theme functions out into separate files quite easily.
  2172. * - path: Override the path of the file to be used. Ordinarily the module or
  2173. * theme path will be used, but if the file will not be in the default
  2174. * path, include it here. This path should be relative to the Drupal root
  2175. * directory.
  2176. * - template: If specified, this theme implementation is a template, and
  2177. * this is the template file without an extension. Do not put .tpl.php on
  2178. * this file; that extension will be added automatically by the default
  2179. * rendering engine (which is PHPTemplate). If 'path', above, is specified,
  2180. * the template should also be in this path.
  2181. * - function: If specified, this will be the function name to invoke for
  2182. * this implementation. If neither 'template' nor 'function' is specified,
  2183. * a default function name will be assumed. For example, if a module
  2184. * registers the 'node' theme hook, 'theme_node' will be assigned to its
  2185. * function. If the chameleon theme registers the node hook, it will be
  2186. * assigned 'chameleon_node' as its function.
  2187. * - base hook: A string declaring the base theme hook if this theme
  2188. * implementation is actually implementing a suggestion for another theme
  2189. * hook.
  2190. * - pattern: A regular expression pattern to be used to allow this theme
  2191. * implementation to have a dynamic name. The convention is to use __ to
  2192. * differentiate the dynamic portion of the theme. For example, to allow
  2193. * forums to be themed individually, the pattern might be: 'forum__'. Then,
  2194. * when the forum is themed, call:
  2195. * @code
  2196. * theme(array('forum__' . $tid, 'forum'), $forum)
  2197. * @endcode
  2198. * - preprocess functions: A list of functions used to preprocess this data.
  2199. * Ordinarily this won't be used; it's automatically filled in. By default,
  2200. * for a module this will be filled in as template_preprocess_HOOK. For
  2201. * a theme this will be filled in as phptemplate_preprocess and
  2202. * phptemplate_preprocess_HOOK as well as themename_preprocess and
  2203. * themename_preprocess_HOOK.
  2204. * - override preprocess functions: Set to TRUE when a theme does NOT want
  2205. * the standard preprocess functions to run. This can be used to give a
  2206. * theme FULL control over how variables are set. For example, if a theme
  2207. * wants total control over how certain variables in the page.tpl.php are
  2208. * set, this can be set to true. Please keep in mind that when this is used
  2209. * by a theme, that theme becomes responsible for making sure necessary
  2210. * variables are set.
  2211. * - type: (automatically derived) Where the theme hook is defined:
  2212. * 'module', 'theme_engine', or 'theme'.
  2213. * - theme path: (automatically derived) The directory path of the theme or
  2214. * module, so that it doesn't need to be looked up.
  2215. *
  2216. * @see hook_theme_registry_alter()
  2217. */
  2218. function hook_theme($existing, $type, $theme, $path) {
  2219. return array(
  2220. 'forum_display' => array(
  2221. 'variables' => array('forums' => NULL, 'topics' => NULL, 'parents' => NULL, 'tid' => NULL, 'sortby' => NULL, 'forum_per_page' => NULL),
  2222. ),
  2223. 'forum_list' => array(
  2224. 'variables' => array('forums' => NULL, 'parents' => NULL, 'tid' => NULL),
  2225. ),
  2226. 'forum_topic_list' => array(
  2227. 'variables' => array('tid' => NULL, 'topics' => NULL, 'sortby' => NULL, 'forum_per_page' => NULL),
  2228. ),
  2229. 'forum_icon' => array(
  2230. 'variables' => array('new_posts' => NULL, 'num_posts' => 0, 'comment_mode' => 0, 'sticky' => 0),
  2231. ),
  2232. 'status_report' => array(
  2233. 'render element' => 'requirements',
  2234. 'file' => 'system.admin.inc',
  2235. ),
  2236. 'system_date_time_settings' => array(
  2237. 'render element' => 'form',
  2238. 'file' => 'system.admin.inc',
  2239. ),
  2240. );
  2241. }
  2242. /**
  2243. * Alter the theme registry information returned from hook_theme().
  2244. *
  2245. * The theme registry stores information about all available theme hooks,
  2246. * including which callback functions those hooks will call when triggered,
  2247. * what template files are exposed by these hooks, and so on.
  2248. *
  2249. * Note that this hook is only executed as the theme cache is re-built.
  2250. * Changes here will not be visible until the next cache clear.
  2251. *
  2252. * The $theme_registry array is keyed by theme hook name, and contains the
  2253. * information returned from hook_theme(), as well as additional properties
  2254. * added by _theme_process_registry().
  2255. *
  2256. * For example:
  2257. * @code
  2258. * $theme_registry['user_profile'] = array(
  2259. * 'variables' => array(
  2260. * 'account' => NULL,
  2261. * ),
  2262. * 'template' => 'modules/user/user-profile',
  2263. * 'file' => 'modules/user/user.pages.inc',
  2264. * 'type' => 'module',
  2265. * 'theme path' => 'modules/user',
  2266. * 'preprocess functions' => array(
  2267. * 0 => 'template_preprocess',
  2268. * 1 => 'template_preprocess_user_profile',
  2269. * ),
  2270. * );
  2271. * @endcode
  2272. *
  2273. * @param $theme_registry
  2274. * The entire cache of theme registry information, post-processing.
  2275. *
  2276. * @see hook_theme()
  2277. * @see _theme_process_registry()
  2278. */
  2279. function hook_theme_registry_alter(&$theme_registry) {
  2280. // Kill the next/previous forum topic navigation links.
  2281. foreach ($theme_registry['forum_topic_navigation']['preprocess functions'] as $key => $value) {
  2282. if ($value == 'template_preprocess_forum_topic_navigation') {
  2283. unset($theme_registry['forum_topic_navigation']['preprocess functions'][$key]);
  2284. }
  2285. }
  2286. }
  2287. /**
  2288. * Return the machine-readable name of the theme to use for the current page.
  2289. *
  2290. * This hook can be used to dynamically set the theme for the current page
  2291. * request. It should be used by modules which need to override the theme
  2292. * based on dynamic conditions (for example, a module which allows the theme to
  2293. * be set based on the current user's role). The return value of this hook will
  2294. * be used on all pages except those which have a valid per-page or per-section
  2295. * theme set via a theme callback function in hook_menu(); the themes on those
  2296. * pages can only be overridden using hook_menu_alter().
  2297. *
  2298. * Note that returning different themes for the same path may not work with page
  2299. * caching. This is most likely to be a problem if an anonymous user on a given
  2300. * path could have different themes returned under different conditions.
  2301. *
  2302. * Since only one theme can be used at a time, the last (i.e., highest
  2303. * weighted) module which returns a valid theme name from this hook will
  2304. * prevail.
  2305. *
  2306. * @return
  2307. * The machine-readable name of the theme that should be used for the current
  2308. * page request. The value returned from this function will only have an
  2309. * effect if it corresponds to a currently-active theme on the site. Do not
  2310. * return a value if you do not wish to set a custom theme.
  2311. */
  2312. function hook_custom_theme() {
  2313. // Allow the user to request a particular theme via a query parameter.
  2314. if (isset($_GET['theme'])) {
  2315. return $_GET['theme'];
  2316. }
  2317. }
  2318. /**
  2319. * Register XML-RPC callbacks.
  2320. *
  2321. * This hook lets a module register callback functions to be called when
  2322. * particular XML-RPC methods are invoked by a client.
  2323. *
  2324. * @return
  2325. * An array which maps XML-RPC methods to Drupal functions. Each array
  2326. * element is either a pair of method => function or an array with four
  2327. * entries:
  2328. * - The XML-RPC method name (for example, module.function).
  2329. * - The Drupal callback function (for example, module_function).
  2330. * - The method signature is an array of XML-RPC types. The first element
  2331. * of this array is the type of return value and then you should write a
  2332. * list of the types of the parameters. XML-RPC types are the following
  2333. * (See the types at http://www.xmlrpc.com/spec):
  2334. * - "boolean": 0 (false) or 1 (true).
  2335. * - "double": a floating point number (for example, -12.214).
  2336. * - "int": a integer number (for example, -12).
  2337. * - "array": an array without keys (for example, array(1, 2, 3)).
  2338. * - "struct": an associative array or an object (for example,
  2339. * array('one' => 1, 'two' => 2)).
  2340. * - "date": when you return a date, then you may either return a
  2341. * timestamp (time(), mktime() etc.) or an ISO8601 timestamp. When
  2342. * date is specified as an input parameter, then you get an object,
  2343. * which is described in the function xmlrpc_date
  2344. * - "base64": a string containing binary data, automatically
  2345. * encoded/decoded automatically.
  2346. * - "string": anything else, typically a string.
  2347. * - A descriptive help string, enclosed in a t() function for translation
  2348. * purposes.
  2349. * Both forms are shown in the example.
  2350. */
  2351. function hook_xmlrpc() {
  2352. return array(
  2353. 'drupal.login' => 'drupal_login',
  2354. array(
  2355. 'drupal.site.ping',
  2356. 'drupal_directory_ping',
  2357. array('boolean', 'string', 'string', 'string', 'string', 'string'),
  2358. t('Handling ping request'))
  2359. );
  2360. }
  2361. /**
  2362. * Alters the definition of XML-RPC methods before they are called.
  2363. *
  2364. * This hook allows modules to modify the callback definition of declared
  2365. * XML-RPC methods, right before they are invoked by a client. Methods may be
  2366. * added, or existing methods may be altered.
  2367. *
  2368. * Note that hook_xmlrpc() supports two distinct and incompatible formats to
  2369. * define a callback, so care must be taken when altering other methods.
  2370. *
  2371. * @param $methods
  2372. * An asssociative array of method callback definitions, as returned from
  2373. * hook_xmlrpc() implementations.
  2374. *
  2375. * @see hook_xmlrpc()
  2376. * @see xmlrpc_server()
  2377. */
  2378. function hook_xmlrpc_alter(&$methods) {
  2379. // Directly change a simple method.
  2380. $methods['drupal.login'] = 'mymodule_login';
  2381. // Alter complex definitions.
  2382. foreach ($methods as $key => &$method) {
  2383. // Skip simple method definitions.
  2384. if (!is_int($key)) {
  2385. continue;
  2386. }
  2387. // Perform the wanted manipulation.
  2388. if ($method[0] == 'drupal.site.ping') {
  2389. $method[1] = 'mymodule_directory_ping';
  2390. }
  2391. }
  2392. }
  2393. /**
  2394. * Log an event message.
  2395. *
  2396. * This hook allows modules to route log events to custom destinations, such as
  2397. * SMS, Email, pager, syslog, ...etc.
  2398. *
  2399. * @param $log_entry
  2400. * An associative array containing the following keys:
  2401. * - type: The type of message for this entry.
  2402. * - user: The user object for the user who was logged in when the event
  2403. * happened.
  2404. * - uid: The user ID for the user who was logged in when the event happened.
  2405. * - request_uri: The request URI for the page the event happened in.
  2406. * - referer: The page that referred the user to the page where the event
  2407. * occurred.
  2408. * - ip: The IP address where the request for the page came from.
  2409. * - timestamp: The UNIX timestamp of the date/time the event occurred.
  2410. * - severity: The severity of the message; one of the following values as
  2411. * defined in @link http://www.faqs.org/rfcs/rfc3164.html RFC 3164: @endlink
  2412. * - WATCHDOG_EMERGENCY: Emergency, system is unusable.
  2413. * - WATCHDOG_ALERT: Alert, action must be taken immediately.
  2414. * - WATCHDOG_CRITICAL: Critical conditions.
  2415. * - WATCHDOG_ERROR: Error conditions.
  2416. * - WATCHDOG_WARNING: Warning conditions.
  2417. * - WATCHDOG_NOTICE: Normal but significant conditions.
  2418. * - WATCHDOG_INFO: Informational messages.
  2419. * - WATCHDOG_DEBUG: Debug-level messages.
  2420. * - link: An optional link provided by the module that called the watchdog()
  2421. * function.
  2422. * - message: The text of the message to be logged. Variables in the message
  2423. * are indicated by using placeholder strings alongside the variables
  2424. * argument to declare the value of the placeholders. See t() for
  2425. * documentation on how the message and variable parameters interact.
  2426. * - variables: An array of variables to be inserted into the message on
  2427. * display. Will be NULL or missing if a message is already translated or if
  2428. * the message is not possible to translate.
  2429. */
  2430. function hook_watchdog(array $log_entry) {
  2431. global $base_url, $language;
  2432. $severity_list = array(
  2433. WATCHDOG_EMERGENCY => t('Emergency'),
  2434. WATCHDOG_ALERT => t('Alert'),
  2435. WATCHDOG_CRITICAL => t('Critical'),
  2436. WATCHDOG_ERROR => t('Error'),
  2437. WATCHDOG_WARNING => t('Warning'),
  2438. WATCHDOG_NOTICE => t('Notice'),
  2439. WATCHDOG_INFO => t('Info'),
  2440. WATCHDOG_DEBUG => t('Debug'),
  2441. );
  2442. $to = 'someone@example.com';
  2443. $params = array();
  2444. $params['subject'] = t('[@site_name] @severity_desc: Alert from your web site', array(
  2445. '@site_name' => variable_get('site_name', 'Drupal'),
  2446. '@severity_desc' => $severity_list[$log_entry['severity']],
  2447. ));
  2448. $params['message'] = "\nSite: @base_url";
  2449. $params['message'] .= "\nSeverity: (@severity) @severity_desc";
  2450. $params['message'] .= "\nTimestamp: @timestamp";
  2451. $params['message'] .= "\nType: @type";
  2452. $params['message'] .= "\nIP Address: @ip";
  2453. $params['message'] .= "\nRequest URI: @request_uri";
  2454. $params['message'] .= "\nReferrer URI: @referer_uri";
  2455. $params['message'] .= "\nUser: (@uid) @name";
  2456. $params['message'] .= "\nLink: @link";
  2457. $params['message'] .= "\nMessage: \n\n@message";
  2458. $params['message'] = t($params['message'], array(
  2459. '@base_url' => $base_url,
  2460. '@severity' => $log_entry['severity'],
  2461. '@severity_desc' => $severity_list[$log_entry['severity']],
  2462. '@timestamp' => format_date($log_entry['timestamp']),
  2463. '@type' => $log_entry['type'],
  2464. '@ip' => $log_entry['ip'],
  2465. '@request_uri' => $log_entry['request_uri'],
  2466. '@referer_uri' => $log_entry['referer'],
  2467. '@uid' => $log_entry['uid'],
  2468. '@name' => $log_entry['user']->name,
  2469. '@link' => strip_tags($log_entry['link']),
  2470. '@message' => strip_tags($log_entry['message']),
  2471. ));
  2472. drupal_mail('emaillog', 'entry', $to, $language, $params);
  2473. }
  2474. /**
  2475. * Prepare a message based on parameters; called from drupal_mail().
  2476. *
  2477. * Note that hook_mail(), unlike hook_mail_alter(), is only called on the
  2478. * $module argument to drupal_mail(), not all modules.
  2479. *
  2480. * @param $key
  2481. * An identifier of the mail.
  2482. * @param $message
  2483. * An array to be filled in. Elements in this array include:
  2484. * - id: An ID to identify the mail sent. Look at module source code
  2485. * or drupal_mail() for possible id values.
  2486. * - to: The address or addresses the message will be sent to. The formatting
  2487. * of this string will be validated with the
  2488. * @link http://php.net/manual/filter.filters.validate.php PHP e-mail validation filter. @endlink
  2489. * - subject: Subject of the e-mail to be sent. This must not contain any
  2490. * newline characters, or the mail may not be sent properly. drupal_mail()
  2491. * sets this to an empty string when the hook is invoked.
  2492. * - body: An array of lines containing the message to be sent. Drupal will
  2493. * format the correct line endings for you. drupal_mail() sets this to an
  2494. * empty array when the hook is invoked.
  2495. * - from: The address the message will be marked as being from, which is
  2496. * set by drupal_mail() to either a custom address or the site-wide
  2497. * default email address when the hook is invoked.
  2498. * - headers: Associative array containing mail headers, such as From,
  2499. * Sender, MIME-Version, Content-Type, etc. drupal_mail() pre-fills
  2500. * several headers in this array.
  2501. * @param $params
  2502. * An array of parameters supplied by the caller of drupal_mail().
  2503. */
  2504. function hook_mail($key, &$message, $params) {
  2505. $account = $params['account'];
  2506. $context = $params['context'];
  2507. $variables = array(
  2508. '%site_name' => variable_get('site_name', 'Drupal'),
  2509. '%username' => format_username($account),
  2510. );
  2511. if ($context['hook'] == 'taxonomy') {
  2512. $entity = $params['entity'];
  2513. $vocabulary = taxonomy_vocabulary_load($entity->vid);
  2514. $variables += array(
  2515. '%term_name' => $entity->name,
  2516. '%term_description' => $entity->description,
  2517. '%term_id' => $entity->tid,
  2518. '%vocabulary_name' => $vocabulary->name,
  2519. '%vocabulary_description' => $vocabulary->description,
  2520. '%vocabulary_id' => $vocabulary->vid,
  2521. );
  2522. }
  2523. // Node-based variable translation is only available if we have a node.
  2524. if (isset($params['node'])) {
  2525. $node = $params['node'];
  2526. $variables += array(
  2527. '%uid' => $node->uid,
  2528. '%node_url' => url('node/' . $node->nid, array('absolute' => TRUE)),
  2529. '%node_type' => node_type_get_name($node),
  2530. '%title' => $node->title,
  2531. '%teaser' => $node->teaser,
  2532. '%body' => $node->body,
  2533. );
  2534. }
  2535. $subject = strtr($context['subject'], $variables);
  2536. $body = strtr($context['message'], $variables);
  2537. $message['subject'] .= str_replace(array("\r", "\n"), '', $subject);
  2538. $message['body'][] = drupal_html_to_text($body);
  2539. }
  2540. /**
  2541. * Add a list of cache tables to be cleared.
  2542. *
  2543. * This hook allows your module to add cache table names to the list of cache
  2544. * tables that will be cleared by the Clear button on the Performance page or
  2545. * whenever drupal_flush_all_caches is invoked.
  2546. *
  2547. * @return
  2548. * An array of cache table names.
  2549. *
  2550. * @see drupal_flush_all_caches()
  2551. */
  2552. function hook_flush_caches() {
  2553. return array('cache_example');
  2554. }
  2555. /**
  2556. * Perform necessary actions after modules are installed.
  2557. *
  2558. * This function differs from hook_install() in that it gives all other modules
  2559. * a chance to perform actions when a module is installed, whereas
  2560. * hook_install() is only called on the module actually being installed. See
  2561. * module_enable() for a detailed description of the order in which install and
  2562. * enable hooks are invoked.
  2563. *
  2564. * This hook should be implemented in a .module file, not in an .install file.
  2565. *
  2566. * @param $modules
  2567. * An array of the modules that were installed.
  2568. *
  2569. * @see module_enable()
  2570. * @see hook_modules_enabled()
  2571. * @see hook_install()
  2572. */
  2573. function hook_modules_installed($modules) {
  2574. if (in_array('lousy_module', $modules)) {
  2575. variable_set('lousy_module_conflicting_variable', FALSE);
  2576. }
  2577. }
  2578. /**
  2579. * Perform necessary actions after modules are enabled.
  2580. *
  2581. * This function differs from hook_enable() in that it gives all other modules a
  2582. * chance to perform actions when modules are enabled, whereas hook_enable() is
  2583. * only called on the module actually being enabled. See module_enable() for a
  2584. * detailed description of the order in which install and enable hooks are
  2585. * invoked.
  2586. *
  2587. * @param $modules
  2588. * An array of the modules that were enabled.
  2589. *
  2590. * @see hook_enable()
  2591. * @see hook_modules_installed()
  2592. * @see module_enable()
  2593. */
  2594. function hook_modules_enabled($modules) {
  2595. if (in_array('lousy_module', $modules)) {
  2596. drupal_set_message(t('mymodule is not compatible with lousy_module'), 'error');
  2597. mymodule_disable_functionality();
  2598. }
  2599. }
  2600. /**
  2601. * Perform necessary actions after modules are disabled.
  2602. *
  2603. * This function differs from hook_disable() in that it gives all other modules
  2604. * a chance to perform actions when modules are disabled, whereas hook_disable()
  2605. * is only called on the module actually being disabled.
  2606. *
  2607. * @param $modules
  2608. * An array of the modules that were disabled.
  2609. *
  2610. * @see hook_disable()
  2611. * @see hook_modules_uninstalled()
  2612. */
  2613. function hook_modules_disabled($modules) {
  2614. if (in_array('lousy_module', $modules)) {
  2615. mymodule_enable_functionality();
  2616. }
  2617. }
  2618. /**
  2619. * Perform necessary actions after modules are uninstalled.
  2620. *
  2621. * This function differs from hook_uninstall() in that it gives all other
  2622. * modules a chance to perform actions when a module is uninstalled, whereas
  2623. * hook_uninstall() is only called on the module actually being uninstalled.
  2624. *
  2625. * It is recommended that you implement this hook if your module stores
  2626. * data that may have been set by other modules.
  2627. *
  2628. * @param $modules
  2629. * An array of the modules that were uninstalled.
  2630. *
  2631. * @see hook_uninstall()
  2632. * @see hook_modules_disabled()
  2633. */
  2634. function hook_modules_uninstalled($modules) {
  2635. foreach ($modules as $module) {
  2636. db_delete('mymodule_table')
  2637. ->condition('module', $module)
  2638. ->execute();
  2639. }
  2640. mymodule_cache_rebuild();
  2641. }
  2642. /**
  2643. * Registers PHP stream wrapper implementations associated with a module.
  2644. *
  2645. * Provide a facility for managing and querying user-defined stream wrappers
  2646. * in PHP. PHP's internal stream_get_wrappers() doesn't return the class
  2647. * registered to handle a stream, which we need to be able to find the handler
  2648. * for class instantiation.
  2649. *
  2650. * If a module registers a scheme that is already registered with PHP, it will
  2651. * be unregistered and replaced with the specified class.
  2652. *
  2653. * @return
  2654. * A nested array, keyed first by scheme name ("public" for "public://"),
  2655. * then keyed by the following values:
  2656. * - 'name' A short string to name the wrapper.
  2657. * - 'class' A string specifying the PHP class that implements the
  2658. * DrupalStreamWrapperInterface interface.
  2659. * - 'description' A string with a short description of what the wrapper does.
  2660. * - 'type' (Optional) A bitmask of flags indicating what type of streams this
  2661. * wrapper will access - local or remote, readable and/or writeable, etc.
  2662. * Many shortcut constants are defined in stream_wrappers.inc. Defaults to
  2663. * STREAM_WRAPPERS_NORMAL which includes all of these bit flags:
  2664. * - STREAM_WRAPPERS_READ
  2665. * - STREAM_WRAPPERS_WRITE
  2666. * - STREAM_WRAPPERS_VISIBLE
  2667. *
  2668. * @see file_get_stream_wrappers()
  2669. * @see hook_stream_wrappers_alter()
  2670. * @see system_stream_wrappers()
  2671. */
  2672. function hook_stream_wrappers() {
  2673. return array(
  2674. 'public' => array(
  2675. 'name' => t('Public files'),
  2676. 'class' => 'DrupalPublicStreamWrapper',
  2677. 'description' => t('Public local files served by the webserver.'),
  2678. 'type' => STREAM_WRAPPERS_LOCAL_NORMAL,
  2679. ),
  2680. 'private' => array(
  2681. 'name' => t('Private files'),
  2682. 'class' => 'DrupalPrivateStreamWrapper',
  2683. 'description' => t('Private local files served by Drupal.'),
  2684. 'type' => STREAM_WRAPPERS_LOCAL_NORMAL,
  2685. ),
  2686. 'temp' => array(
  2687. 'name' => t('Temporary files'),
  2688. 'class' => 'DrupalTempStreamWrapper',
  2689. 'description' => t('Temporary local files for upload and previews.'),
  2690. 'type' => STREAM_WRAPPERS_LOCAL_HIDDEN,
  2691. ),
  2692. 'cdn' => array(
  2693. 'name' => t('Content delivery network files'),
  2694. 'class' => 'MyModuleCDNStreamWrapper',
  2695. 'description' => t('Files served by a content delivery network.'),
  2696. // 'type' can be omitted to use the default of STREAM_WRAPPERS_NORMAL
  2697. ),
  2698. 'youtube' => array(
  2699. 'name' => t('YouTube video'),
  2700. 'class' => 'MyModuleYouTubeStreamWrapper',
  2701. 'description' => t('Video streamed from YouTube.'),
  2702. // A module implementing YouTube integration may decide to support using
  2703. // the YouTube API for uploading video, but here, we assume that this
  2704. // particular module only supports playing YouTube video.
  2705. 'type' => STREAM_WRAPPERS_READ_VISIBLE,
  2706. ),
  2707. );
  2708. }
  2709. /**
  2710. * Alters the list of PHP stream wrapper implementations.
  2711. *
  2712. * @see file_get_stream_wrappers()
  2713. * @see hook_stream_wrappers()
  2714. */
  2715. function hook_stream_wrappers_alter(&$wrappers) {
  2716. // Change the name of private files to reflect the performance.
  2717. $wrappers['private']['name'] = t('Slow files');
  2718. }
  2719. /**
  2720. * Load additional information into file objects.
  2721. *
  2722. * file_load_multiple() calls this hook to allow modules to load
  2723. * additional information into each file.
  2724. *
  2725. * @param $files
  2726. * An array of file objects, indexed by fid.
  2727. *
  2728. * @see file_load_multiple()
  2729. * @see file_load()
  2730. */
  2731. function hook_file_load($files) {
  2732. // Add the upload specific data into the file object.
  2733. $result = db_query('SELECT * FROM {upload} u WHERE u.fid IN (:fids)', array(':fids' => array_keys($files)))->fetchAll(PDO::FETCH_ASSOC);
  2734. foreach ($result as $record) {
  2735. foreach ($record as $key => $value) {
  2736. $files[$record['fid']]->$key = $value;
  2737. }
  2738. }
  2739. }
  2740. /**
  2741. * Check that files meet a given criteria.
  2742. *
  2743. * This hook lets modules perform additional validation on files. They're able
  2744. * to report a failure by returning one or more error messages.
  2745. *
  2746. * @param $file
  2747. * The file object being validated.
  2748. * @return
  2749. * An array of error messages. If there are no problems with the file return
  2750. * an empty array.
  2751. *
  2752. * @see file_validate()
  2753. */
  2754. function hook_file_validate($file) {
  2755. $errors = array();
  2756. if (empty($file->filename)) {
  2757. $errors[] = t("The file's name is empty. Please give a name to the file.");
  2758. }
  2759. if (strlen($file->filename) > 255) {
  2760. $errors[] = t("The file's name exceeds the 255 characters limit. Please rename the file and try again.");
  2761. }
  2762. return $errors;
  2763. }
  2764. /**
  2765. * Act on a file being inserted or updated.
  2766. *
  2767. * This hook is called when a file has been added to the database. The hook
  2768. * doesn't distinguish between files created as a result of a copy or those
  2769. * created by an upload.
  2770. *
  2771. * @param $file
  2772. * The file that has just been created.
  2773. *
  2774. * @see file_save()
  2775. */
  2776. function hook_file_presave($file) {
  2777. // Change the file timestamp to an hour prior.
  2778. $file->timestamp -= 3600;
  2779. }
  2780. /**
  2781. * Respond to a file being added.
  2782. *
  2783. * This hook is called after a file has been added to the database. The hook
  2784. * doesn't distinguish between files created as a result of a copy or those
  2785. * created by an upload.
  2786. *
  2787. * @param $file
  2788. * The file that has been added.
  2789. *
  2790. * @see file_save()
  2791. */
  2792. function hook_file_insert($file) {
  2793. // Add a message to the log, if the file is a jpg
  2794. $validate = file_validate_extensions($file, 'jpg');
  2795. if (empty($validate)) {
  2796. watchdog('file', 'A jpg has been added.');
  2797. }
  2798. }
  2799. /**
  2800. * Respond to a file being updated.
  2801. *
  2802. * This hook is called when file_save() is called on an existing file.
  2803. *
  2804. * @param $file
  2805. * The file that has just been updated.
  2806. *
  2807. * @see file_save()
  2808. */
  2809. function hook_file_update($file) {
  2810. $file_user = user_load($file->uid);
  2811. // Make sure that the file name starts with the owner's user name.
  2812. if (strpos($file->filename, $file_user->name) !== 0) {
  2813. $old_filename = $file->filename;
  2814. $file->filename = $file_user->name . '_' . $file->filename;
  2815. $file->save();
  2816. watchdog('file', t('%source has been renamed to %destination', array('%source' => $old_filename, '%destination' => $file->filename)));
  2817. }
  2818. }
  2819. /**
  2820. * Respond to a file that has been copied.
  2821. *
  2822. * @param $file
  2823. * The newly copied file object.
  2824. * @param $source
  2825. * The original file before the copy.
  2826. *
  2827. * @see file_copy()
  2828. */
  2829. function hook_file_copy($file, $source) {
  2830. $file_user = user_load($file->uid);
  2831. // Make sure that the file name starts with the owner's user name.
  2832. if (strpos($file->filename, $file_user->name) !== 0) {
  2833. $file->filename = $file_user->name . '_' . $file->filename;
  2834. $file->save();
  2835. watchdog('file', t('Copied file %source has been renamed to %destination', array('%source' => $source->filename, '%destination' => $file->filename)));
  2836. }
  2837. }
  2838. /**
  2839. * Respond to a file that has been moved.
  2840. *
  2841. * @param $file
  2842. * The updated file object after the move.
  2843. * @param $source
  2844. * The original file object before the move.
  2845. *
  2846. * @see file_move()
  2847. */
  2848. function hook_file_move($file, $source) {
  2849. $file_user = user_load($file->uid);
  2850. // Make sure that the file name starts with the owner's user name.
  2851. if (strpos($file->filename, $file_user->name) !== 0) {
  2852. $file->filename = $file_user->name . '_' . $file->filename;
  2853. $file->save();
  2854. watchdog('file', t('Moved file %source has been renamed to %destination', array('%source' => $source->filename, '%destination' => $file->filename)));
  2855. }
  2856. }
  2857. /**
  2858. * Respond to a file being deleted.
  2859. *
  2860. * @param $file
  2861. * The file that has just been deleted.
  2862. *
  2863. * @see file_delete()
  2864. */
  2865. function hook_file_delete($file) {
  2866. // Delete all information associated with the file.
  2867. db_delete('upload')->condition('fid', $file->fid)->execute();
  2868. }
  2869. /**
  2870. * Control access to private file downloads and specify HTTP headers.
  2871. *
  2872. * This hook allows modules enforce permissions on file downloads when the
  2873. * private file download method is selected. Modules can also provide headers
  2874. * to specify information like the file's name or MIME type.
  2875. *
  2876. * @param $uri
  2877. * The URI of the file.
  2878. * @return
  2879. * If the user does not have permission to access the file, return -1. If the
  2880. * user has permission, return an array with the appropriate headers. If the
  2881. * file is not controlled by the current module, the return value should be
  2882. * NULL.
  2883. *
  2884. * @see file_download()
  2885. */
  2886. function hook_file_download($uri) {
  2887. // Check if the file is controlled by the current module.
  2888. if (!file_prepare_directory($uri)) {
  2889. $uri = FALSE;
  2890. }
  2891. if (strpos(file_uri_target($uri), variable_get('user_picture_path', 'pictures') . '/picture-') === 0) {
  2892. if (!user_access('access user profiles')) {
  2893. // Access to the file is denied.
  2894. return -1;
  2895. }
  2896. else {
  2897. $info = image_get_info($uri);
  2898. return array('Content-Type' => $info['mime_type']);
  2899. }
  2900. }
  2901. }
  2902. /**
  2903. * Alter the URL to a file.
  2904. *
  2905. * This hook is called from file_create_url(), and is called fairly
  2906. * frequently (10+ times per page), depending on how many files there are in a
  2907. * given page.
  2908. * If CSS and JS aggregation are disabled, this can become very frequently
  2909. * (50+ times per page) so performance is critical.
  2910. *
  2911. * This function should alter the URI, if it wants to rewrite the file URL.
  2912. *
  2913. * @param $uri
  2914. * The URI to a file for which we need an external URL, or the path to a
  2915. * shipped file.
  2916. */
  2917. function hook_file_url_alter(&$uri) {
  2918. global $user;
  2919. // User 1 will always see the local file in this example.
  2920. if ($user->uid == 1) {
  2921. return;
  2922. }
  2923. $cdn1 = 'http://cdn1.example.com';
  2924. $cdn2 = 'http://cdn2.example.com';
  2925. $cdn_extensions = array('css', 'js', 'gif', 'jpg', 'jpeg', 'png');
  2926. // Most CDNs don't support private file transfers without a lot of hassle,
  2927. // so don't support this in the common case.
  2928. $schemes = array('public');
  2929. $scheme = file_uri_scheme($uri);
  2930. // Only serve shipped files and public created files from the CDN.
  2931. if (!$scheme || in_array($scheme, $schemes)) {
  2932. // Shipped files.
  2933. if (!$scheme) {
  2934. $path = $uri;
  2935. }
  2936. // Public created files.
  2937. else {
  2938. $wrapper = file_stream_wrapper_get_instance_by_scheme($scheme);
  2939. $path = $wrapper->getDirectoryPath() . '/' . file_uri_target($uri);
  2940. }
  2941. // Clean up Windows paths.
  2942. $path = str_replace('\\', '/', $path);
  2943. // Serve files with one of the CDN extensions from CDN 1, all others from
  2944. // CDN 2.
  2945. $pathinfo = pathinfo($path);
  2946. if (isset($pathinfo['extension']) && in_array($pathinfo['extension'], $cdn_extensions)) {
  2947. $uri = $cdn1 . '/' . $path;
  2948. }
  2949. else {
  2950. $uri = $cdn2 . '/' . $path;
  2951. }
  2952. }
  2953. }
  2954. /**
  2955. * Check installation requirements and do status reporting.
  2956. *
  2957. * This hook has three closely related uses, determined by the $phase argument:
  2958. * - Checking installation requirements ($phase == 'install').
  2959. * - Checking update requirements ($phase == 'update').
  2960. * - Status reporting ($phase == 'runtime').
  2961. *
  2962. * Note that this hook, like all others dealing with installation and updates,
  2963. * must reside in a module_name.install file, or it will not properly abort
  2964. * the installation of the module if a critical requirement is missing.
  2965. *
  2966. * During the 'install' phase, modules can for example assert that
  2967. * library or server versions are available or sufficient.
  2968. * Note that the installation of a module can happen during installation of
  2969. * Drupal itself (by install.php) with an installation profile or later by hand.
  2970. * As a consequence, install-time requirements must be checked without access
  2971. * to the full Drupal API, because it is not available during install.php.
  2972. * For localization you should for example use $t = get_t() to
  2973. * retrieve the appropriate localization function name (t() or st()).
  2974. * If a requirement has a severity of REQUIREMENT_ERROR, install.php will abort
  2975. * or at least the module will not install.
  2976. * Other severity levels have no effect on the installation.
  2977. * Module dependencies do not belong to these installation requirements,
  2978. * but should be defined in the module's .info file.
  2979. *
  2980. * The 'runtime' phase is not limited to pure installation requirements
  2981. * but can also be used for more general status information like maintenance
  2982. * tasks and security issues.
  2983. * The returned 'requirements' will be listed on the status report in the
  2984. * administration section, with indication of the severity level.
  2985. * Moreover, any requirement with a severity of REQUIREMENT_ERROR severity will
  2986. * result in a notice on the administration configuration page.
  2987. *
  2988. * @param $phase
  2989. * The phase in which requirements are checked:
  2990. * - install: The module is being installed.
  2991. * - update: The module is enabled and update.php is run.
  2992. * - runtime: The runtime requirements are being checked and shown on the
  2993. * status report page.
  2994. *
  2995. * @return
  2996. * An associative array where the keys are arbitrary but must be unique (it
  2997. * is suggested to use the module short name as a prefix) and the values are
  2998. * themselves associative arrays with the following elements:
  2999. * - title: The name of the requirement.
  3000. * - value: The current value (e.g., version, time, level, etc). During
  3001. * install phase, this should only be used for version numbers, do not set
  3002. * it if not applicable.
  3003. * - description: The description of the requirement/status.
  3004. * - severity: The requirement's result/severity level, one of:
  3005. * - REQUIREMENT_INFO: For info only.
  3006. * - REQUIREMENT_OK: The requirement is satisfied.
  3007. * - REQUIREMENT_WARNING: The requirement failed with a warning.
  3008. * - REQUIREMENT_ERROR: The requirement failed with an error.
  3009. */
  3010. function hook_requirements($phase) {
  3011. $requirements = array();
  3012. // Ensure translations don't break during installation.
  3013. $t = get_t();
  3014. // Report Drupal version
  3015. if ($phase == 'runtime') {
  3016. $requirements['drupal'] = array(
  3017. 'title' => $t('Drupal'),
  3018. 'value' => VERSION,
  3019. 'severity' => REQUIREMENT_INFO
  3020. );
  3021. }
  3022. // Test PHP version
  3023. $requirements['php'] = array(
  3024. 'title' => $t('PHP'),
  3025. 'value' => ($phase == 'runtime') ? l(phpversion(), 'admin/reports/status/php') : phpversion(),
  3026. );
  3027. if (version_compare(phpversion(), DRUPAL_MINIMUM_PHP) < 0) {
  3028. $requirements['php']['description'] = $t('Your PHP installation is too old. Drupal requires at least PHP %version.', array('%version' => DRUPAL_MINIMUM_PHP));
  3029. $requirements['php']['severity'] = REQUIREMENT_ERROR;
  3030. }
  3031. // Report cron status
  3032. if ($phase == 'runtime') {
  3033. $cron_last = variable_get('cron_last');
  3034. if (is_numeric($cron_last)) {
  3035. $requirements['cron']['value'] = $t('Last run !time ago', array('!time' => format_interval(REQUEST_TIME - $cron_last)));
  3036. }
  3037. else {
  3038. $requirements['cron'] = array(
  3039. 'description' => $t('Cron has not run. It appears cron jobs have not been setup on your system. Check the help pages for <a href="@url">configuring cron jobs</a>.', array('@url' => 'http://drupal.org/cron')),
  3040. 'severity' => REQUIREMENT_ERROR,
  3041. 'value' => $t('Never run'),
  3042. );
  3043. }
  3044. $requirements['cron']['description'] .= ' ' . $t('You can <a href="@cron">run cron manually</a>.', array('@cron' => url('admin/reports/status/run-cron')));
  3045. $requirements['cron']['title'] = $t('Cron maintenance tasks');
  3046. }
  3047. return $requirements;
  3048. }
  3049. /**
  3050. * Define the current version of the database schema.
  3051. *
  3052. * A Drupal schema definition is an array structure representing one or more
  3053. * tables and their related keys and indexes. A schema is defined by
  3054. * hook_schema() which must live in your module's .install file.
  3055. *
  3056. * This hook is called at install and uninstall time, and in the latter case, it
  3057. * cannot rely on the .module file being loaded or hooks being known. If the
  3058. * .module file is needed, it may be loaded with drupal_load().
  3059. *
  3060. * The tables declared by this hook will be automatically created when the
  3061. * module is first enabled, and removed when the module is uninstalled. This
  3062. * happens before hook_install() is invoked, and after hook_uninstall() is
  3063. * invoked, respectively.
  3064. *
  3065. * By declaring the tables used by your module via an implementation of
  3066. * hook_schema(), these tables will be available on all supported database
  3067. * engines. You don't have to deal with the different SQL dialects for table
  3068. * creation and alteration of the supported database engines.
  3069. *
  3070. * See the Schema API Handbook at http://drupal.org/node/146843 for details on
  3071. * schema definition structures. Note that foreign key definitions are for
  3072. * documentation purposes only; foreign keys are not created in the database,
  3073. * nor are they enforced by Drupal.
  3074. *
  3075. * @return array
  3076. * A schema definition structure array. For each element of the
  3077. * array, the key is a table name and the value is a table structure
  3078. * definition.
  3079. *
  3080. * @see hook_schema_alter()
  3081. *
  3082. * @ingroup schemaapi
  3083. */
  3084. function hook_schema() {
  3085. $schema['node'] = array(
  3086. // Example (partial) specification for table "node".
  3087. 'description' => 'The base table for nodes.',
  3088. 'fields' => array(
  3089. 'nid' => array(
  3090. 'description' => 'The primary identifier for a node.',
  3091. 'type' => 'serial',
  3092. 'unsigned' => TRUE,
  3093. 'not null' => TRUE,
  3094. ),
  3095. 'vid' => array(
  3096. 'description' => 'The current {node_revision}.vid version identifier.',
  3097. 'type' => 'int',
  3098. 'unsigned' => TRUE,
  3099. 'not null' => TRUE,
  3100. 'default' => 0,
  3101. ),
  3102. 'type' => array(
  3103. 'description' => 'The {node_type} of this node.',
  3104. 'type' => 'varchar',
  3105. 'length' => 32,
  3106. 'not null' => TRUE,
  3107. 'default' => '',
  3108. ),
  3109. 'title' => array(
  3110. 'description' => 'The title of this node, always treated as non-markup plain text.',
  3111. 'type' => 'varchar',
  3112. 'length' => 255,
  3113. 'not null' => TRUE,
  3114. 'default' => '',
  3115. ),
  3116. ),
  3117. 'indexes' => array(
  3118. 'node_changed' => array('changed'),
  3119. 'node_created' => array('created'),
  3120. ),
  3121. 'unique keys' => array(
  3122. 'nid_vid' => array('nid', 'vid'),
  3123. 'vid' => array('vid'),
  3124. ),
  3125. // For documentation purposes only; foreign keys are not created in the
  3126. // database.
  3127. 'foreign keys' => array(
  3128. 'node_revision' => array(
  3129. 'table' => 'node_revision',
  3130. 'columns' => array('vid' => 'vid'),
  3131. ),
  3132. 'node_author' => array(
  3133. 'table' => 'users',
  3134. 'columns' => array('uid' => 'uid'),
  3135. ),
  3136. ),
  3137. 'primary key' => array('nid'),
  3138. );
  3139. return $schema;
  3140. }
  3141. /**
  3142. * Perform alterations to existing database schemas.
  3143. *
  3144. * When a module modifies the database structure of another module (by
  3145. * changing, adding or removing fields, keys or indexes), it should
  3146. * implement hook_schema_alter() to update the default $schema to take its
  3147. * changes into account.
  3148. *
  3149. * See hook_schema() for details on the schema definition structure.
  3150. *
  3151. * @param $schema
  3152. * Nested array describing the schemas for all modules.
  3153. *
  3154. * @ingroup schemaapi
  3155. */
  3156. function hook_schema_alter(&$schema) {
  3157. // Add field to existing schema.
  3158. $schema['users']['fields']['timezone_id'] = array(
  3159. 'type' => 'int',
  3160. 'not null' => TRUE,
  3161. 'default' => 0,
  3162. 'description' => 'Per-user timezone configuration.',
  3163. );
  3164. }
  3165. /**
  3166. * Perform alterations to a structured query.
  3167. *
  3168. * Structured (aka dynamic) queries that have tags associated may be altered by any module
  3169. * before the query is executed.
  3170. *
  3171. * @param $query
  3172. * A Query object describing the composite parts of a SQL query.
  3173. *
  3174. * @see hook_query_TAG_alter()
  3175. * @see node_query_node_access_alter()
  3176. * @see QueryAlterableInterface
  3177. * @see SelectQueryInterface
  3178. */
  3179. function hook_query_alter(QueryAlterableInterface $query) {
  3180. if ($query->hasTag('micro_limit')) {
  3181. $query->range(0, 2);
  3182. }
  3183. }
  3184. /**
  3185. * Perform alterations to a structured query for a given tag.
  3186. *
  3187. * @param $query
  3188. * An Query object describing the composite parts of a SQL query.
  3189. *
  3190. * @see hook_query_alter()
  3191. * @see node_query_node_access_alter()
  3192. * @see QueryAlterableInterface
  3193. * @see SelectQueryInterface
  3194. */
  3195. function hook_query_TAG_alter(QueryAlterableInterface $query) {
  3196. // Skip the extra expensive alterations if site has no node access control modules.
  3197. if (!node_access_view_all_nodes()) {
  3198. // Prevent duplicates records.
  3199. $query->distinct();
  3200. // The recognized operations are 'view', 'update', 'delete'.
  3201. if (!$op = $query->getMetaData('op')) {
  3202. $op = 'view';
  3203. }
  3204. // Skip the extra joins and conditions for node admins.
  3205. if (!user_access('bypass node access')) {
  3206. // The node_access table has the access grants for any given node.
  3207. $access_alias = $query->join('node_access', 'na', '%alias.nid = n.nid');
  3208. $or = db_or();
  3209. // If any grant exists for the specified user, then user has access to the node for the specified operation.
  3210. foreach (node_access_grants($op, $query->getMetaData('account')) as $realm => $gids) {
  3211. foreach ($gids as $gid) {
  3212. $or->condition(db_and()
  3213. ->condition($access_alias . '.gid', $gid)
  3214. ->condition($access_alias . '.realm', $realm)
  3215. );
  3216. }
  3217. }
  3218. if (count($or->conditions())) {
  3219. $query->condition($or);
  3220. }
  3221. $query->condition($access_alias . 'grant_' . $op, 1, '>=');
  3222. }
  3223. }
  3224. }
  3225. /**
  3226. * Perform setup tasks when the module is installed.
  3227. *
  3228. * If the module implements hook_schema(), the database tables will
  3229. * be created before this hook is fired.
  3230. *
  3231. * Implementations of this hook are by convention declared in the module's
  3232. * .install file. The implementation can rely on the .module file being loaded.
  3233. * The hook will only be called the first time a module is enabled or after it
  3234. * is re-enabled after being uninstalled. The module's schema version will be
  3235. * set to the module's greatest numbered update hook. Because of this, any time
  3236. * a hook_update_N() is added to the module, this function needs to be updated
  3237. * to reflect the current version of the database schema.
  3238. *
  3239. * See the @link http://drupal.org/node/146843 Schema API documentation @endlink
  3240. * for details on hook_schema and how database tables are defined.
  3241. *
  3242. * Note that since this function is called from a full bootstrap, all functions
  3243. * (including those in modules enabled by the current page request) are
  3244. * available when this hook is called. Use cases could be displaying a user
  3245. * message, or calling a module function necessary for initial setup, etc.
  3246. *
  3247. * Please be sure that anything added or modified in this function that can
  3248. * be removed during uninstall should be removed with hook_uninstall().
  3249. *
  3250. * @see hook_schema()
  3251. * @see module_enable()
  3252. * @see hook_enable()
  3253. * @see hook_disable()
  3254. * @see hook_uninstall()
  3255. * @see hook_modules_installed()
  3256. */
  3257. function hook_install() {
  3258. // Populate the default {node_access} record.
  3259. db_insert('node_access')
  3260. ->fields(array(
  3261. 'nid' => 0,
  3262. 'gid' => 0,
  3263. 'realm' => 'all',
  3264. 'grant_view' => 1,
  3265. 'grant_update' => 0,
  3266. 'grant_delete' => 0,
  3267. ))
  3268. ->execute();
  3269. }
  3270. /**
  3271. * Perform a single update.
  3272. *
  3273. * For each change that requires one or more actions to be performed when
  3274. * updating a site, add a new hook_update_N(), which will be called by
  3275. * update.php. The documentation block preceding this function is stripped of
  3276. * newlines and used as the description for the update on the pending updates
  3277. * task list. Schema updates should adhere to the
  3278. * @link http://drupal.org/node/150215 Schema API. @endlink
  3279. *
  3280. * Implementations of hook_update_N() are named (module name)_update_(number).
  3281. * The numbers are composed of three parts:
  3282. * - 1 digit for Drupal core compatibility.
  3283. * - 1 digit for your module's major release version (e.g., is this the 7.x-1.*
  3284. * (1) or 7.x-2.* (2) series of your module?). This digit should be 0 for
  3285. * initial porting of your module to a new Drupal core API.
  3286. * - 2 digits for sequential counting, starting with 00.
  3287. *
  3288. * Examples:
  3289. * - mymodule_update_7000(): This is the required update for mymodule to run
  3290. * with Drupal core API 7.x when upgrading from Drupal core API 6.x.
  3291. * - mymodule_update_7100(): This is the first update to get the database ready
  3292. * to run mymodule 7.x-1.*.
  3293. * - mymodule_update_7200(): This is the first update to get the database ready
  3294. * to run mymodule 7.x-2.*. Users can directly update from 6.x-2.* to 7.x-2.*
  3295. * and they get all 70xx and 72xx updates, but not 71xx updates, because
  3296. * those reside in the 7.x-1.x branch only.
  3297. *
  3298. * A good rule of thumb is to remove updates older than two major releases of
  3299. * Drupal. See hook_update_last_removed() to notify Drupal about the removals.
  3300. * For further information about releases and release numbers see:
  3301. * @link http://drupal.org/node/711070 Maintaining a drupal.org project with Git @endlink
  3302. *
  3303. * Never renumber update functions.
  3304. *
  3305. * Implementations of this hook should be placed in a mymodule.install file in
  3306. * the same directory as mymodule.module. Drupal core's updates are implemented
  3307. * using the system module as a name and stored in database/updates.inc.
  3308. *
  3309. * Not all module functions are available from within a hook_update_N() function.
  3310. * In order to call a function from your mymodule.module or an include file,
  3311. * you need to explicitly load that file first.
  3312. *
  3313. * During database updates the schema of any module could be out of date. For
  3314. * this reason, caution is needed when using any API function within an update
  3315. * function - particularly CRUD functions, functions that depend on the schema
  3316. * (for example by using drupal_write_record()), and any functions that invoke
  3317. * hooks. See @link update_api Update versions of API functions @endlink for
  3318. * details.
  3319. *
  3320. * The $sandbox parameter should be used when a multipass update is needed, in
  3321. * circumstances where running the whole update at once could cause PHP to
  3322. * timeout. Each pass is run in a way that avoids PHP timeouts, provided each
  3323. * pass remains under the timeout limit. To signify that an update requires
  3324. * at least one more pass, set $sandbox['#finished'] to a number less than 1
  3325. * (you need to do this each pass). The value of $sandbox['#finished'] will be
  3326. * unset between passes but all other data in $sandbox will be preserved. The
  3327. * system will stop iterating this update when $sandbox['#finished'] is left
  3328. * unset or set to a number higher than 1. It is recommended that
  3329. * $sandbox['#finished'] is initially set to 0, and then updated each pass to a
  3330. * number between 0 and 1 that represents the overall % completed for this
  3331. * update, finishing with 1.
  3332. *
  3333. * See the @link batch Batch operations topic @endlink for more information on
  3334. * how to use the Batch API.
  3335. *
  3336. * @param array $sandbox
  3337. * Stores information for multipass updates. See above for more information.
  3338. *
  3339. * @throws DrupalUpdateException|PDOException
  3340. * In case of error, update hooks should throw an instance of DrupalUpdateException
  3341. * with a meaningful message for the user. If a database query fails for whatever
  3342. * reason, it will throw a PDOException.
  3343. *
  3344. * @return string|null
  3345. * Optionally, update hooks may return a translated string that will be
  3346. * displayed to the user after the update has completed. If no message is
  3347. * returned, no message will be presented to the user.
  3348. *
  3349. * @see batch
  3350. * @see schemaapi
  3351. * @see update_api
  3352. * @see hook_update_last_removed()
  3353. * @see update_get_update_list()
  3354. */
  3355. function hook_update_N(&$sandbox) {
  3356. // For non-multipass updates, the signature can simply be;
  3357. // function hook_update_N() {
  3358. // For most updates, the following is sufficient.
  3359. db_add_field('mytable1', 'newcol', array('type' => 'int', 'not null' => TRUE, 'description' => 'My new integer column.'));
  3360. // However, for more complex operations that may take a long time,
  3361. // you may hook into Batch API as in the following example.
  3362. // Update 3 users at a time to have an exclamation point after their names.
  3363. // (They're really happy that we can do batch API in this hook!)
  3364. if (!isset($sandbox['progress'])) {
  3365. $sandbox['progress'] = 0;
  3366. $sandbox['current_uid'] = 0;
  3367. // We'll -1 to disregard the uid 0...
  3368. $sandbox['max'] = db_query('SELECT COUNT(DISTINCT uid) FROM {users}')->fetchField() - 1;
  3369. }
  3370. $users = db_select('users', 'u')
  3371. ->fields('u', array('uid', 'name'))
  3372. ->condition('uid', $sandbox['current_uid'], '>')
  3373. ->range(0, 3)
  3374. ->orderBy('uid', 'ASC')
  3375. ->execute();
  3376. foreach ($users as $user) {
  3377. $user->name .= '!';
  3378. db_update('users')
  3379. ->fields(array('name' => $user->name))
  3380. ->condition('uid', $user->uid)
  3381. ->execute();
  3382. $sandbox['progress']++;
  3383. $sandbox['current_uid'] = $user->uid;
  3384. }
  3385. $sandbox['#finished'] = empty($sandbox['max']) ? 1 : ($sandbox['progress'] / $sandbox['max']);
  3386. // To display a message to the user when the update is completed, return it.
  3387. // If you do not want to display a completion message, simply return nothing.
  3388. return t('The update did what it was supposed to do.');
  3389. // In case of an error, simply throw an exception with an error message.
  3390. throw new DrupalUpdateException('Something went wrong; here is what you should do.');
  3391. }
  3392. /**
  3393. * Return an array of information about module update dependencies.
  3394. *
  3395. * This can be used to indicate update functions from other modules that your
  3396. * module's update functions depend on, or vice versa. It is used by the update
  3397. * system to determine the appropriate order in which updates should be run, as
  3398. * well as to search for missing dependencies.
  3399. *
  3400. * Implementations of this hook should be placed in a mymodule.install file in
  3401. * the same directory as mymodule.module.
  3402. *
  3403. * @return
  3404. * A multidimensional array containing information about the module update
  3405. * dependencies. The first two levels of keys represent the module and update
  3406. * number (respectively) for which information is being returned, and the
  3407. * value is an array of information about that update's dependencies. Within
  3408. * this array, each key represents a module, and each value represents the
  3409. * number of an update function within that module. In the event that your
  3410. * update function depends on more than one update from a particular module,
  3411. * you should always list the highest numbered one here (since updates within
  3412. * a given module always run in numerical order).
  3413. *
  3414. * @see update_resolve_dependencies()
  3415. * @see hook_update_N()
  3416. */
  3417. function hook_update_dependencies() {
  3418. // Indicate that the mymodule_update_7000() function provided by this module
  3419. // must run after the another_module_update_7002() function provided by the
  3420. // 'another_module' module.
  3421. $dependencies['mymodule'][7000] = array(
  3422. 'another_module' => 7002,
  3423. );
  3424. // Indicate that the mymodule_update_7001() function provided by this module
  3425. // must run before the yet_another_module_update_7004() function provided by
  3426. // the 'yet_another_module' module. (Note that declaring dependencies in this
  3427. // direction should be done only in rare situations, since it can lead to the
  3428. // following problem: If a site has already run the yet_another_module
  3429. // module's database updates before it updates its codebase to pick up the
  3430. // newest mymodule code, then the dependency declared here will be ignored.)
  3431. $dependencies['yet_another_module'][7004] = array(
  3432. 'mymodule' => 7001,
  3433. );
  3434. return $dependencies;
  3435. }
  3436. /**
  3437. * Return a number which is no longer available as hook_update_N().
  3438. *
  3439. * If you remove some update functions from your mymodule.install file, you
  3440. * should notify Drupal of those missing functions. This way, Drupal can
  3441. * ensure that no update is accidentally skipped.
  3442. *
  3443. * Implementations of this hook should be placed in a mymodule.install file in
  3444. * the same directory as mymodule.module.
  3445. *
  3446. * @return
  3447. * An integer, corresponding to hook_update_N() which has been removed from
  3448. * mymodule.install.
  3449. *
  3450. * @see hook_update_N()
  3451. */
  3452. function hook_update_last_removed() {
  3453. // We've removed the 5.x-1.x version of mymodule, including database updates.
  3454. // The next update function is mymodule_update_5200().
  3455. return 5103;
  3456. }
  3457. /**
  3458. * Remove any information that the module sets.
  3459. *
  3460. * The information that the module should remove includes:
  3461. * - variables that the module has set using variable_set() or system_settings_form()
  3462. * - modifications to existing tables
  3463. *
  3464. * The module should not remove its entry from the {system} table. Database
  3465. * tables defined by hook_schema() will be removed automatically.
  3466. *
  3467. * The uninstall hook must be implemented in the module's .install file. It
  3468. * will fire when the module gets uninstalled but before the module's database
  3469. * tables are removed, allowing your module to query its own tables during
  3470. * this routine.
  3471. *
  3472. * When hook_uninstall() is called, your module will already be disabled, so
  3473. * its .module file will not be automatically included. If you need to call API
  3474. * functions from your .module file in this hook, use drupal_load() to make
  3475. * them available. (Keep this usage to a minimum, though, especially when
  3476. * calling API functions that invoke hooks, or API functions from modules
  3477. * listed as dependencies, since these may not be available or work as expected
  3478. * when the module is disabled.)
  3479. *
  3480. * @see hook_install()
  3481. * @see hook_schema()
  3482. * @see hook_disable()
  3483. * @see hook_modules_uninstalled()
  3484. */
  3485. function hook_uninstall() {
  3486. variable_del('upload_file_types');
  3487. }
  3488. /**
  3489. * Perform necessary actions after module is enabled.
  3490. *
  3491. * The hook is called every time the module is enabled. It should be
  3492. * implemented in the module's .install file. The implementation can
  3493. * rely on the .module file being loaded.
  3494. *
  3495. * @see module_enable()
  3496. * @see hook_install()
  3497. * @see hook_modules_enabled()
  3498. */
  3499. function hook_enable() {
  3500. mymodule_cache_rebuild();
  3501. }
  3502. /**
  3503. * Perform necessary actions before module is disabled.
  3504. *
  3505. * The hook is called every time the module is disabled. It should be
  3506. * implemented in the module's .install file. The implementation can rely
  3507. * on the .module file being loaded.
  3508. *
  3509. * @see hook_uninstall()
  3510. * @see hook_modules_disabled()
  3511. */
  3512. function hook_disable() {
  3513. mymodule_cache_rebuild();
  3514. }
  3515. /**
  3516. * Perform necessary alterations to the list of files parsed by the registry.
  3517. *
  3518. * Modules can manually modify the list of files before the registry parses
  3519. * them. The $modules array provides the .info file information, which includes
  3520. * the list of files registered to each module. Any files in the list can then
  3521. * be added to the list of files that the registry will parse, or modify
  3522. * attributes of a file.
  3523. *
  3524. * A necessary alteration made by the core SimpleTest module is to force .test
  3525. * files provided by disabled modules into the list of files parsed by the
  3526. * registry.
  3527. *
  3528. * @param $files
  3529. * List of files to be parsed by the registry. The list will contain
  3530. * files found in each enabled module's info file and the core includes
  3531. * directory. The array is keyed by the file path and contains an array of
  3532. * the related module's name and weight as used internally by
  3533. * _registry_update() and related functions.
  3534. *
  3535. * For example:
  3536. * @code
  3537. * $files["modules/system/system.module"] = array(
  3538. * 'module' => 'system',
  3539. * 'weight' => 0,
  3540. * );
  3541. * @endcode
  3542. * @param $modules
  3543. * An array containing all module information stored in the {system} table.
  3544. * Each element of the array also contains the module's .info file
  3545. * information in the property 'info'. An additional 'dir' property has been
  3546. * added to the module information which provides the path to the directory
  3547. * in which the module resides. The example shows how to take advantage of
  3548. * both properties.
  3549. *
  3550. * @see _registry_update()
  3551. * @see simpletest_test_get_all()
  3552. */
  3553. function hook_registry_files_alter(&$files, $modules) {
  3554. foreach ($modules as $module) {
  3555. // Only add test files for disabled modules, as enabled modules should
  3556. // already include any test files they provide.
  3557. if (!$module->status) {
  3558. $dir = $module->dir;
  3559. foreach ($module->info['files'] as $file) {
  3560. if (substr($file, -5) == '.test') {
  3561. $files["$dir/$file"] = array('module' => $module->name, 'weight' => $module->weight);
  3562. }
  3563. }
  3564. }
  3565. }
  3566. }
  3567. /**
  3568. * Return an array of tasks to be performed by an installation profile.
  3569. *
  3570. * Any tasks you define here will be run, in order, after the installer has
  3571. * finished the site configuration step but before it has moved on to the
  3572. * final import of languages and the end of the installation. This is invoked
  3573. * by install_tasks(). You can have any number of custom tasks to perform
  3574. * during this phase.
  3575. *
  3576. * Each task you define here corresponds to a callback function which you must
  3577. * separately define and which is called when your task is run. This function
  3578. * will receive the global installation state variable, $install_state, as
  3579. * input, and has the opportunity to access or modify any of its settings. See
  3580. * the install_state_defaults() function in the installer for the list of
  3581. * $install_state settings used by Drupal core.
  3582. *
  3583. * At the end of your task function, you can indicate that you want the
  3584. * installer to pause and display a page to the user by returning any themed
  3585. * output that should be displayed on that page (but see below for tasks that
  3586. * use the form API or batch API; the return values of these task functions are
  3587. * handled differently). You should also use drupal_set_title() within the task
  3588. * callback function to set a custom page title. For some tasks, however, you
  3589. * may want to simply do some processing and pass control to the next task
  3590. * without ending the page request; to indicate this, simply do not send back
  3591. * a return value from your task function at all. This can be used, for
  3592. * example, by installation profiles that need to configure certain site
  3593. * settings in the database without obtaining any input from the user.
  3594. *
  3595. * The task function is treated specially if it defines a form or requires
  3596. * batch processing; in that case, you should return either the form API
  3597. * definition or batch API array, as appropriate. See below for more
  3598. * information on the 'type' key that you must define in the task definition
  3599. * to inform the installer that your task falls into one of those two
  3600. * categories. It is important to use these APIs directly, since the installer
  3601. * may be run non-interactively (for example, via a command line script), all
  3602. * in one page request; in that case, the installer will automatically take
  3603. * care of submitting forms and processing batches correctly for both types of
  3604. * installations. You can inspect the $install_state['interactive'] boolean to
  3605. * see whether or not the current installation is interactive, if you need
  3606. * access to this information.
  3607. *
  3608. * Remember that a user installing Drupal interactively will be able to reload
  3609. * an installation page multiple times, so you should use variable_set() and
  3610. * variable_get() if you are collecting any data that you need to store and
  3611. * inspect later. It is important to remove any temporary variables using
  3612. * variable_del() before your last task has completed and control is handed
  3613. * back to the installer.
  3614. *
  3615. * @param array $install_state
  3616. * An array of information about the current installation state.
  3617. *
  3618. * @return array
  3619. * A keyed array of tasks the profile will perform during the final stage of
  3620. * the installation. Each key represents the name of a function (usually a
  3621. * function defined by this profile, although that is not strictly required)
  3622. * that is called when that task is run. The values are associative arrays
  3623. * containing the following key-value pairs (all of which are optional):
  3624. * - display_name: The human-readable name of the task. This will be
  3625. * displayed to the user while the installer is running, along with a list
  3626. * of other tasks that are being run. Leave this unset to prevent the task
  3627. * from appearing in the list.
  3628. * - display: This is a boolean which can be used to provide finer-grained
  3629. * control over whether or not the task will display. This is mostly useful
  3630. * for tasks that are intended to display only under certain conditions;
  3631. * for these tasks, you can set 'display_name' to the name that you want to
  3632. * display, but then use this boolean to hide the task only when certain
  3633. * conditions apply.
  3634. * - type: A string representing the type of task. This parameter has three
  3635. * possible values:
  3636. * - normal: (default) This indicates that the task will be treated as a
  3637. * regular callback function, which does its processing and optionally
  3638. * returns HTML output.
  3639. * - batch: This indicates that the task function will return a batch API
  3640. * definition suitable for batch_set(). The installer will then take care
  3641. * of automatically running the task via batch processing.
  3642. * - form: This indicates that the task function will return a standard
  3643. * form API definition (and separately define validation and submit
  3644. * handlers, as appropriate). The installer will then take care of
  3645. * automatically directing the user through the form submission process.
  3646. * - run: A constant representing the manner in which the task will be run.
  3647. * This parameter has three possible values:
  3648. * - INSTALL_TASK_RUN_IF_NOT_COMPLETED: (default) This indicates that the
  3649. * task will run once during the installation of the profile.
  3650. * - INSTALL_TASK_SKIP: This indicates that the task will not run during
  3651. * the current installation page request. It can be used to skip running
  3652. * an installation task when certain conditions are met, even though the
  3653. * task may still show on the list of installation tasks presented to the
  3654. * user.
  3655. * - INSTALL_TASK_RUN_IF_REACHED: This indicates that the task will run on
  3656. * each installation page request that reaches it. This is rarely
  3657. * necessary for an installation profile to use; it is primarily used by
  3658. * the Drupal installer for bootstrap-related tasks.
  3659. * - function: Normally this does not need to be set, but it can be used to
  3660. * force the installer to call a different function when the task is run
  3661. * (rather than the function whose name is given by the array key). This
  3662. * could be used, for example, to allow the same function to be called by
  3663. * two different tasks.
  3664. *
  3665. * @see install_state_defaults()
  3666. * @see batch_set()
  3667. * @see hook_install_tasks_alter()
  3668. * @see install_tasks()
  3669. */
  3670. function hook_install_tasks(&$install_state) {
  3671. // Here, we define a variable to allow tasks to indicate that a particular,
  3672. // processor-intensive batch process needs to be triggered later on in the
  3673. // installation.
  3674. $myprofile_needs_batch_processing = variable_get('myprofile_needs_batch_processing', FALSE);
  3675. $tasks = array(
  3676. // This is an example of a task that defines a form which the user who is
  3677. // installing the site will be asked to fill out. To implement this task,
  3678. // your profile would define a function named myprofile_data_import_form()
  3679. // as a normal form API callback function, with associated validation and
  3680. // submit handlers. In the submit handler, in addition to saving whatever
  3681. // other data you have collected from the user, you might also call
  3682. // variable_set('myprofile_needs_batch_processing', TRUE) if the user has
  3683. // entered data which requires that batch processing will need to occur
  3684. // later on.
  3685. 'myprofile_data_import_form' => array(
  3686. 'display_name' => st('Data import options'),
  3687. 'type' => 'form',
  3688. ),
  3689. // Similarly, to implement this task, your profile would define a function
  3690. // named myprofile_settings_form() with associated validation and submit
  3691. // handlers. This form might be used to collect and save additional
  3692. // information from the user that your profile needs. There are no extra
  3693. // steps required for your profile to act as an "installation wizard"; you
  3694. // can simply define as many tasks of type 'form' as you wish to execute,
  3695. // and the forms will be presented to the user, one after another.
  3696. 'myprofile_settings_form' => array(
  3697. 'display_name' => st('Additional options'),
  3698. 'type' => 'form',
  3699. ),
  3700. // This is an example of a task that performs batch operations. To
  3701. // implement this task, your profile would define a function named
  3702. // myprofile_batch_processing() which returns a batch API array definition
  3703. // that the installer will use to execute your batch operations. Due to the
  3704. // 'myprofile_needs_batch_processing' variable used here, this task will be
  3705. // hidden and skipped unless your profile set it to TRUE in one of the
  3706. // previous tasks.
  3707. 'myprofile_batch_processing' => array(
  3708. 'display_name' => st('Import additional data'),
  3709. 'display' => $myprofile_needs_batch_processing,
  3710. 'type' => 'batch',
  3711. 'run' => $myprofile_needs_batch_processing ? INSTALL_TASK_RUN_IF_NOT_COMPLETED : INSTALL_TASK_SKIP,
  3712. ),
  3713. // This is an example of a task that will not be displayed in the list that
  3714. // the user sees. To implement this task, your profile would define a
  3715. // function named myprofile_final_site_setup(), in which additional,
  3716. // automated site setup operations would be performed. Since this is the
  3717. // last task defined by your profile, you should also use this function to
  3718. // call variable_del('myprofile_needs_batch_processing') and clean up the
  3719. // variable that was used above. If you want the user to pass to the final
  3720. // Drupal installation tasks uninterrupted, return no output from this
  3721. // function. Otherwise, return themed output that the user will see (for
  3722. // example, a confirmation page explaining that your profile's tasks are
  3723. // complete, with a link to reload the current page and therefore pass on
  3724. // to the final Drupal installation tasks when the user is ready to do so).
  3725. 'myprofile_final_site_setup' => array(
  3726. ),
  3727. );
  3728. return $tasks;
  3729. }
  3730. /**
  3731. * Change the page the user is sent to by drupal_goto().
  3732. *
  3733. * @param $path
  3734. * A Drupal path or a full URL.
  3735. * @param $options
  3736. * An associative array of additional URL options to pass to url().
  3737. * @param $http_response_code
  3738. * The HTTP status code to use for the redirection. See drupal_goto() for more
  3739. * information.
  3740. */
  3741. function hook_drupal_goto_alter(&$path, &$options, &$http_response_code) {
  3742. // A good addition to misery module.
  3743. $http_response_code = 500;
  3744. }
  3745. /**
  3746. * Alter XHTML HEAD tags before they are rendered by drupal_get_html_head().
  3747. *
  3748. * Elements available to be altered are only those added using
  3749. * drupal_add_html_head_link() or drupal_add_html_head(). CSS and JS files
  3750. * are handled using drupal_add_css() and drupal_add_js(), so the head links
  3751. * for those files will not appear in the $head_elements array.
  3752. *
  3753. * @param $head_elements
  3754. * An array of renderable elements. Generally the values of the #attributes
  3755. * array will be the most likely target for changes.
  3756. */
  3757. function hook_html_head_alter(&$head_elements) {
  3758. foreach ($head_elements as $key => $element) {
  3759. if (isset($element['#attributes']['rel']) && $element['#attributes']['rel'] == 'canonical') {
  3760. // I want a custom canonical URL.
  3761. $head_elements[$key]['#attributes']['href'] = mymodule_canonical_url();
  3762. }
  3763. }
  3764. }
  3765. /**
  3766. * Alter the full list of installation tasks.
  3767. *
  3768. * This hook is invoked on the install profile in install_tasks().
  3769. *
  3770. * @param $tasks
  3771. * An array of all available installation tasks, including those provided by
  3772. * Drupal core. You can modify this array to change or replace any part of
  3773. * the Drupal installation process that occurs after the installation profile
  3774. * is selected.
  3775. * @param $install_state
  3776. * An array of information about the current installation state.
  3777. *
  3778. * @see hook_install_tasks()
  3779. * @see install_tasks()
  3780. */
  3781. function hook_install_tasks_alter(&$tasks, $install_state) {
  3782. // Replace the "Choose language" installation task provided by Drupal core
  3783. // with a custom callback function defined by this installation profile.
  3784. $tasks['install_select_locale']['function'] = 'myprofile_locale_selection';
  3785. }
  3786. /**
  3787. * Alter MIME type mappings used to determine MIME type from a file extension.
  3788. *
  3789. * This hook is run when file_mimetype_mapping() is called. It is used to
  3790. * allow modules to add to or modify the default mapping from
  3791. * file_default_mimetype_mapping().
  3792. *
  3793. * @param $mapping
  3794. * An array of mimetypes correlated to the extensions that relate to them.
  3795. * The array has 'mimetypes' and 'extensions' elements, each of which is an
  3796. * array.
  3797. *
  3798. * @see file_default_mimetype_mapping()
  3799. */
  3800. function hook_file_mimetype_mapping_alter(&$mapping) {
  3801. // Add new MIME type 'drupal/info'.
  3802. $mapping['mimetypes']['example_info'] = 'drupal/info';
  3803. // Add new extension '.info' and map it to the 'drupal/info' MIME type.
  3804. $mapping['extensions']['info'] = 'example_info';
  3805. // Override existing extension mapping for '.ogg' files.
  3806. $mapping['extensions']['ogg'] = 189;
  3807. }
  3808. /**
  3809. * Declares information about actions.
  3810. *
  3811. * Any module can define actions, and then call actions_do() to make those
  3812. * actions happen in response to events. The trigger module provides a user
  3813. * interface for associating actions with module-defined triggers, and it makes
  3814. * sure the core triggers fire off actions when their events happen.
  3815. *
  3816. * An action consists of two or three parts:
  3817. * - an action definition (returned by this hook)
  3818. * - a function which performs the action (which by convention is named
  3819. * MODULE_description-of-function_action)
  3820. * - an optional form definition function that defines a configuration form
  3821. * (which has the name of the action function with '_form' appended to it.)
  3822. *
  3823. * The action function takes two to four arguments, which come from the input
  3824. * arguments to actions_do().
  3825. *
  3826. * @return
  3827. * An associative array of action descriptions. The keys of the array
  3828. * are the names of the action functions, and each corresponding value
  3829. * is an associative array with the following key-value pairs:
  3830. * - 'type': The type of object this action acts upon. Core actions have types
  3831. * 'node', 'user', 'comment', and 'system'.
  3832. * - 'label': The human-readable name of the action, which should be passed
  3833. * through the t() function for translation.
  3834. * - 'configurable': If FALSE, then the action doesn't require any extra
  3835. * configuration. If TRUE, then your module must define a form function with
  3836. * the same name as the action function with '_form' appended (e.g., the
  3837. * form for 'node_assign_owner_action' is 'node_assign_owner_action_form'.)
  3838. * This function takes $context as its only parameter, and is paired with
  3839. * the usual _submit function, and possibly a _validate function.
  3840. * - 'triggers': An array of the events (that is, hooks) that can trigger this
  3841. * action. For example: array('node_insert', 'user_update'). You can also
  3842. * declare support for any trigger by returning array('any') for this value.
  3843. * - 'behavior': (optional) A machine-readable array of behaviors of this
  3844. * action, used to signal additionally required actions that may need to be
  3845. * triggered. Currently recognized behaviors by Trigger module:
  3846. * - 'changes_property': If an action with this behavior is assigned to a
  3847. * trigger other than a "presave" hook, any save actions also assigned to
  3848. * this trigger are moved later in the list. If no save action is present,
  3849. * one will be added.
  3850. * Modules that are processing actions (like Trigger module) should take
  3851. * special care for the "presave" hook, in which case a dependent "save"
  3852. * action should NOT be invoked.
  3853. *
  3854. * @ingroup actions
  3855. */
  3856. function hook_action_info() {
  3857. return array(
  3858. 'comment_unpublish_action' => array(
  3859. 'type' => 'comment',
  3860. 'label' => t('Unpublish comment'),
  3861. 'configurable' => FALSE,
  3862. 'behavior' => array('changes_property'),
  3863. 'triggers' => array('comment_presave', 'comment_insert', 'comment_update'),
  3864. ),
  3865. 'comment_unpublish_by_keyword_action' => array(
  3866. 'type' => 'comment',
  3867. 'label' => t('Unpublish comment containing keyword(s)'),
  3868. 'configurable' => TRUE,
  3869. 'behavior' => array('changes_property'),
  3870. 'triggers' => array('comment_presave', 'comment_insert', 'comment_update'),
  3871. ),
  3872. 'comment_save_action' => array(
  3873. 'type' => 'comment',
  3874. 'label' => t('Save comment'),
  3875. 'configurable' => FALSE,
  3876. 'triggers' => array('comment_insert', 'comment_update'),
  3877. ),
  3878. );
  3879. }
  3880. /**
  3881. * Executes code after an action is deleted.
  3882. *
  3883. * @param $aid
  3884. * The action ID.
  3885. */
  3886. function hook_actions_delete($aid) {
  3887. db_delete('actions_assignments')
  3888. ->condition('aid', $aid)
  3889. ->execute();
  3890. }
  3891. /**
  3892. * Alters the actions declared by another module.
  3893. *
  3894. * Called by actions_list() to allow modules to alter the return values from
  3895. * implementations of hook_action_info().
  3896. *
  3897. * @see trigger_example_action_info_alter()
  3898. */
  3899. function hook_action_info_alter(&$actions) {
  3900. $actions['node_unpublish_action']['label'] = t('Unpublish and remove from public view.');
  3901. }
  3902. /**
  3903. * Declare archivers to the system.
  3904. *
  3905. * An archiver is a class that is able to package and unpackage one or more files
  3906. * into a single possibly compressed file. Common examples of such files are
  3907. * zip files and tar.gz files. All archiver classes must implement
  3908. * ArchiverInterface.
  3909. *
  3910. * Each entry should be keyed on a unique value, and specify three
  3911. * additional keys:
  3912. * - class: The name of the PHP class for this archiver.
  3913. * - extensions: An array of file extensions that this archiver supports.
  3914. * - weight: This optional key specifies the weight of this archiver.
  3915. * When mapping file extensions to archivers, the first archiver by
  3916. * weight found that supports the requested extension will be used.
  3917. *
  3918. * @see hook_archiver_info_alter()
  3919. */
  3920. function hook_archiver_info() {
  3921. return array(
  3922. 'tar' => array(
  3923. 'class' => 'ArchiverTar',
  3924. 'extensions' => array('tar', 'tar.gz', 'tar.bz2'),
  3925. ),
  3926. );
  3927. }
  3928. /**
  3929. * Alter archiver information declared by other modules.
  3930. *
  3931. * See hook_archiver_info() for a description of archivers and the archiver
  3932. * information structure.
  3933. *
  3934. * @param $info
  3935. * Archiver information to alter (return values from hook_archiver_info()).
  3936. */
  3937. function hook_archiver_info_alter(&$info) {
  3938. $info['tar']['extensions'][] = 'tgz';
  3939. }
  3940. /**
  3941. * Define additional date types.
  3942. *
  3943. * Next to the 'long', 'medium' and 'short' date types defined in core, any
  3944. * module can define additional types that can be used when displaying dates,
  3945. * by implementing this hook. A date type is basically just a name for a date
  3946. * format.
  3947. *
  3948. * Date types are used in the administration interface: a user can assign
  3949. * date format types defined in hook_date_formats() to date types defined in
  3950. * this hook. Once a format has been assigned by a user, the machine name of a
  3951. * type can be used in the format_date() function to format a date using the
  3952. * chosen formatting.
  3953. *
  3954. * To define a date type in a module and make sure a format has been assigned to
  3955. * it, without requiring a user to visit the administrative interface, use
  3956. * @code variable_set('date_format_' . $type, $format); @endcode
  3957. * where $type is the machine-readable name defined here, and $format is a PHP
  3958. * date format string.
  3959. *
  3960. * To avoid namespace collisions with date types defined by other modules, it is
  3961. * recommended that each date type starts with the module name. A date type
  3962. * can consist of letters, numbers and underscores.
  3963. *
  3964. * @return
  3965. * An array of date types where the keys are the machine-readable names and
  3966. * the values are the human-readable labels.
  3967. *
  3968. * @see hook_date_formats()
  3969. * @see format_date()
  3970. */
  3971. function hook_date_format_types() {
  3972. // Define the core date format types.
  3973. return array(
  3974. 'long' => t('Long'),
  3975. 'medium' => t('Medium'),
  3976. 'short' => t('Short'),
  3977. );
  3978. }
  3979. /**
  3980. * Modify existing date types.
  3981. *
  3982. * Allows other modules to modify existing date types like 'long'. Called by
  3983. * _system_date_format_types_build(). For instance, A module may use this hook
  3984. * to apply settings across all date types, such as locking all date types so
  3985. * they appear to be provided by the system.
  3986. *
  3987. * @param $types
  3988. * A list of date types. Each date type is keyed by the machine-readable name
  3989. * and the values are associative arrays containing:
  3990. * - is_new: Set to FALSE to override previous settings.
  3991. * - module: The name of the module that created the date type.
  3992. * - type: The machine-readable date type name.
  3993. * - title: The human-readable date type name.
  3994. * - locked: Specifies that the date type is system-provided.
  3995. */
  3996. function hook_date_format_types_alter(&$types) {
  3997. foreach ($types as $name => $type) {
  3998. $types[$name]['locked'] = 1;
  3999. }
  4000. }
  4001. /**
  4002. * Define additional date formats.
  4003. *
  4004. * This hook is used to define the PHP date format strings that can be assigned
  4005. * to date types in the administrative interface. A module can provide date
  4006. * format strings for the core-provided date types ('long', 'medium', and
  4007. * 'short'), or for date types defined in hook_date_format_types() by itself
  4008. * or another module.
  4009. *
  4010. * Since date formats can be locale-specific, you can specify the locales that
  4011. * each date format string applies to. There may be more than one locale for a
  4012. * format. There may also be more than one format for the same locale. For
  4013. * example d/m/Y and Y/m/d work equally well in some locales. You may wish to
  4014. * define some additional date formats that aren't specific to any one locale,
  4015. * for example, "Y m". For these cases, the 'locales' component of the return
  4016. * value should be omitted.
  4017. *
  4018. * Providing a date format here does not normally assign the format to be
  4019. * used with the associated date type -- a user has to choose a format for each
  4020. * date type in the administrative interface. There is one exception: locale
  4021. * initialization chooses a locale-specific format for the three core-provided
  4022. * types (see locale_get_localized_date_format() for details). If your module
  4023. * needs to ensure that a date type it defines has a format associated with it,
  4024. * call @code variable_set('date_format_' . $type, $format); @endcode
  4025. * where $type is the machine-readable name defined in hook_date_format_types(),
  4026. * and $format is a PHP date format string.
  4027. *
  4028. * @return
  4029. * A list of date formats to offer as choices in the administrative
  4030. * interface. Each date format is a keyed array consisting of three elements:
  4031. * - 'type': The date type name that this format can be used with, as
  4032. * declared in an implementation of hook_date_format_types().
  4033. * - 'format': A PHP date format string to use when formatting dates. It
  4034. * can contain any of the formatting options described at
  4035. * http://php.net/manual/function.date.php
  4036. * - 'locales': (optional) An array of 2 and 5 character locale codes,
  4037. * defining which locales this format applies to (for example, 'en',
  4038. * 'en-us', etc.). If your date format is not language-specific, leave this
  4039. * array empty.
  4040. *
  4041. * @see hook_date_format_types()
  4042. */
  4043. function hook_date_formats() {
  4044. return array(
  4045. array(
  4046. 'type' => 'mymodule_extra_long',
  4047. 'format' => 'l jS F Y H:i:s e',
  4048. 'locales' => array('en-ie'),
  4049. ),
  4050. array(
  4051. 'type' => 'mymodule_extra_long',
  4052. 'format' => 'l jS F Y h:i:sa',
  4053. 'locales' => array('en', 'en-us'),
  4054. ),
  4055. array(
  4056. 'type' => 'short',
  4057. 'format' => 'F Y',
  4058. 'locales' => array(),
  4059. ),
  4060. );
  4061. }
  4062. /**
  4063. * Alter date formats declared by another module.
  4064. *
  4065. * Called by _system_date_format_types_build() to allow modules to alter the
  4066. * return values from implementations of hook_date_formats().
  4067. */
  4068. function hook_date_formats_alter(&$formats) {
  4069. foreach ($formats as $id => $format) {
  4070. $formats[$id]['locales'][] = 'en-ca';
  4071. }
  4072. }
  4073. /**
  4074. * Alters the delivery callback used to send the result of the page callback to the browser.
  4075. *
  4076. * Called by drupal_deliver_page() to allow modules to alter how the
  4077. * page is delivered to the browser.
  4078. *
  4079. * This hook is intended for altering the delivery callback based on
  4080. * information unrelated to the path of the page accessed. For example,
  4081. * it can be used to set the delivery callback based on a HTTP request
  4082. * header (as shown in the code sample). To specify a delivery callback
  4083. * based on path information, use hook_menu() or hook_menu_alter().
  4084. *
  4085. * This hook can also be used as an API function that can be used to explicitly
  4086. * set the delivery callback from some other function. For example, for a module
  4087. * named MODULE:
  4088. * @code
  4089. * function MODULE_page_delivery_callback_alter(&$callback, $set = FALSE) {
  4090. * static $stored_callback;
  4091. * if ($set) {
  4092. * $stored_callback = $callback;
  4093. * }
  4094. * elseif (isset($stored_callback)) {
  4095. * $callback = $stored_callback;
  4096. * }
  4097. * }
  4098. * function SOMEWHERE_ELSE() {
  4099. * $desired_delivery_callback = 'foo';
  4100. * MODULE_page_delivery_callback_alter($desired_delivery_callback, TRUE);
  4101. * }
  4102. * @endcode
  4103. *
  4104. * @param $callback
  4105. * The name of a function.
  4106. *
  4107. * @see drupal_deliver_page()
  4108. */
  4109. function hook_page_delivery_callback_alter(&$callback) {
  4110. // jQuery sets a HTTP_X_REQUESTED_WITH header of 'XMLHttpRequest'.
  4111. // If a page would normally be delivered as an html page, and it is called
  4112. // from jQuery, deliver it instead as an Ajax response.
  4113. if (isset($_SERVER['HTTP_X_REQUESTED_WITH']) && $_SERVER['HTTP_X_REQUESTED_WITH'] == 'XMLHttpRequest' && $callback == 'drupal_deliver_html_page') {
  4114. $callback = 'ajax_deliver';
  4115. }
  4116. }
  4117. /**
  4118. * Alters theme operation links.
  4119. *
  4120. * @param $theme_groups
  4121. * An associative array containing groups of themes.
  4122. *
  4123. * @see system_themes_page()
  4124. */
  4125. function hook_system_themes_page_alter(&$theme_groups) {
  4126. foreach ($theme_groups as $state => &$group) {
  4127. foreach ($theme_groups[$state] as &$theme) {
  4128. // Add a foo link to each list of theme operations.
  4129. $theme->operations[] = array(
  4130. 'title' => t('Foo'),
  4131. 'href' => 'admin/appearance/foo',
  4132. 'query' => array('theme' => $theme->name)
  4133. );
  4134. }
  4135. }
  4136. }
  4137. /**
  4138. * Alters inbound URL requests.
  4139. *
  4140. * @param $path
  4141. * The path being constructed, which, if a path alias, has been resolved to a
  4142. * Drupal path by the database, and which also may have been altered by other
  4143. * modules before this one.
  4144. * @param $original_path
  4145. * The original path, before being checked for path aliases or altered by any
  4146. * modules.
  4147. * @param $path_language
  4148. * The language of the path.
  4149. *
  4150. * @see drupal_get_normal_path()
  4151. */
  4152. function hook_url_inbound_alter(&$path, $original_path, $path_language) {
  4153. // Create the path user/me/edit, which allows a user to edit their account.
  4154. if (preg_match('|^user/me/edit(/.*)?|', $path, $matches)) {
  4155. global $user;
  4156. $path = 'user/' . $user->uid . '/edit' . $matches[1];
  4157. }
  4158. }
  4159. /**
  4160. * Alters outbound URLs.
  4161. *
  4162. * @param $path
  4163. * The outbound path to alter, not adjusted for path aliases yet. It won't be
  4164. * adjusted for path aliases until all modules are finished altering it, thus
  4165. * being consistent with hook_url_inbound_alter(), which adjusts for all path
  4166. * aliases before allowing modules to alter it. This may have been altered by
  4167. * other modules before this one.
  4168. * @param $options
  4169. * A set of URL options for the URL so elements such as a fragment or a query
  4170. * string can be added to the URL.
  4171. * @param $original_path
  4172. * The original path, before being altered by any modules.
  4173. *
  4174. * @see url()
  4175. */
  4176. function hook_url_outbound_alter(&$path, &$options, $original_path) {
  4177. // Use an external RSS feed rather than the Drupal one.
  4178. if ($path == 'rss.xml') {
  4179. $path = 'http://example.com/rss.xml';
  4180. $options['external'] = TRUE;
  4181. }
  4182. // Instead of pointing to user/[uid]/edit, point to user/me/edit.
  4183. if (preg_match('|^user/([0-9]*)/edit(/.*)?|', $path, $matches)) {
  4184. global $user;
  4185. if ($user->uid == $matches[1]) {
  4186. $path = 'user/me/edit' . $matches[2];
  4187. }
  4188. }
  4189. }
  4190. /**
  4191. * Alter the username that is displayed for a user.
  4192. *
  4193. * Called by format_username() to allow modules to alter the username that's
  4194. * displayed. Can be used to ensure user privacy in situations where
  4195. * $account->name is too revealing.
  4196. *
  4197. * @param $name
  4198. * The string that format_username() will return.
  4199. *
  4200. * @param $account
  4201. * The account object passed to format_username().
  4202. *
  4203. * @see format_username()
  4204. */
  4205. function hook_username_alter(&$name, $account) {
  4206. // Display the user's uid instead of name.
  4207. if (isset($account->uid)) {
  4208. $name = t('User !uid', array('!uid' => $account->uid));
  4209. }
  4210. }
  4211. /**
  4212. * Provide replacement values for placeholder tokens.
  4213. *
  4214. * This hook is invoked when someone calls token_replace(). That function first
  4215. * scans the text for [type:token] patterns, and splits the needed tokens into
  4216. * groups by type. Then hook_tokens() is invoked on each token-type group,
  4217. * allowing your module to respond by providing replacement text for any of
  4218. * the tokens in the group that your module knows how to process.
  4219. *
  4220. * A module implementing this hook should also implement hook_token_info() in
  4221. * order to list its available tokens on editing screens.
  4222. *
  4223. * @param $type
  4224. * The machine-readable name of the type (group) of token being replaced, such
  4225. * as 'node', 'user', or another type defined by a hook_token_info()
  4226. * implementation.
  4227. * @param $tokens
  4228. * An array of tokens to be replaced. The keys are the machine-readable token
  4229. * names, and the values are the raw [type:token] strings that appeared in the
  4230. * original text.
  4231. * @param $data
  4232. * (optional) An associative array of data objects to be used when generating
  4233. * replacement values, as supplied in the $data parameter to token_replace().
  4234. * @param $options
  4235. * (optional) An associative array of options for token replacement; see
  4236. * token_replace() for possible values.
  4237. *
  4238. * @return
  4239. * An associative array of replacement values, keyed by the raw [type:token]
  4240. * strings from the original text.
  4241. *
  4242. * @see hook_token_info()
  4243. * @see hook_tokens_alter()
  4244. */
  4245. function hook_tokens($type, $tokens, array $data = array(), array $options = array()) {
  4246. $url_options = array('absolute' => TRUE);
  4247. if (isset($options['language'])) {
  4248. $url_options['language'] = $options['language'];
  4249. $language_code = $options['language']->language;
  4250. }
  4251. else {
  4252. $language_code = NULL;
  4253. }
  4254. $sanitize = !empty($options['sanitize']);
  4255. $replacements = array();
  4256. if ($type == 'node' && !empty($data['node'])) {
  4257. $node = $data['node'];
  4258. foreach ($tokens as $name => $original) {
  4259. switch ($name) {
  4260. // Simple key values on the node.
  4261. case 'nid':
  4262. $replacements[$original] = $node->nid;
  4263. break;
  4264. case 'title':
  4265. $replacements[$original] = $sanitize ? check_plain($node->title) : $node->title;
  4266. break;
  4267. case 'edit-url':
  4268. $replacements[$original] = url('node/' . $node->nid . '/edit', $url_options);
  4269. break;
  4270. // Default values for the chained tokens handled below.
  4271. case 'author':
  4272. $name = ($node->uid == 0) ? variable_get('anonymous', t('Anonymous')) : $node->name;
  4273. $replacements[$original] = $sanitize ? filter_xss($name) : $name;
  4274. break;
  4275. case 'created':
  4276. $replacements[$original] = format_date($node->created, 'medium', '', NULL, $language_code);
  4277. break;
  4278. }
  4279. }
  4280. if ($author_tokens = token_find_with_prefix($tokens, 'author')) {
  4281. $author = user_load($node->uid);
  4282. $replacements += token_generate('user', $author_tokens, array('user' => $author), $options);
  4283. }
  4284. if ($created_tokens = token_find_with_prefix($tokens, 'created')) {
  4285. $replacements += token_generate('date', $created_tokens, array('date' => $node->created), $options);
  4286. }
  4287. }
  4288. return $replacements;
  4289. }
  4290. /**
  4291. * Alter replacement values for placeholder tokens.
  4292. *
  4293. * @param $replacements
  4294. * An associative array of replacements returned by hook_tokens().
  4295. * @param $context
  4296. * The context in which hook_tokens() was called. An associative array with
  4297. * the following keys, which have the same meaning as the corresponding
  4298. * parameters of hook_tokens():
  4299. * - 'type'
  4300. * - 'tokens'
  4301. * - 'data'
  4302. * - 'options'
  4303. *
  4304. * @see hook_tokens()
  4305. */
  4306. function hook_tokens_alter(array &$replacements, array $context) {
  4307. $options = $context['options'];
  4308. if (isset($options['language'])) {
  4309. $url_options['language'] = $options['language'];
  4310. $language_code = $options['language']->language;
  4311. }
  4312. else {
  4313. $language_code = NULL;
  4314. }
  4315. $sanitize = !empty($options['sanitize']);
  4316. if ($context['type'] == 'node' && !empty($context['data']['node'])) {
  4317. $node = $context['data']['node'];
  4318. // Alter the [node:title] token, and replace it with the rendered content
  4319. // of a field (field_title).
  4320. if (isset($context['tokens']['title'])) {
  4321. $title = field_view_field('node', $node, 'field_title', 'default', $language_code);
  4322. $replacements[$context['tokens']['title']] = drupal_render($title);
  4323. }
  4324. }
  4325. }
  4326. /**
  4327. * Provide information about available placeholder tokens and token types.
  4328. *
  4329. * Tokens are placeholders that can be put into text by using the syntax
  4330. * [type:token], where type is the machine-readable name of a token type, and
  4331. * token is the machine-readable name of a token within this group. This hook
  4332. * provides a list of types and tokens to be displayed on text editing screens,
  4333. * so that people editing text can see what their token options are.
  4334. *
  4335. * The actual token replacement is done by token_replace(), which invokes
  4336. * hook_tokens(). Your module will need to implement that hook in order to
  4337. * generate token replacements from the tokens defined here.
  4338. *
  4339. * @return
  4340. * An associative array of available tokens and token types. The outer array
  4341. * has two components:
  4342. * - types: An associative array of token types (groups). Each token type is
  4343. * an associative array with the following components:
  4344. * - name: The translated human-readable short name of the token type.
  4345. * - description: A translated longer description of the token type.
  4346. * - needs-data: The type of data that must be provided to token_replace()
  4347. * in the $data argument (i.e., the key name in $data) in order for tokens
  4348. * of this type to be used in the $text being processed. For instance, if
  4349. * the token needs a node object, 'needs-data' should be 'node', and to
  4350. * use this token in token_replace(), the caller needs to supply a node
  4351. * object as $data['node']. Some token data can also be supplied
  4352. * indirectly; for instance, a node object in $data supplies a user object
  4353. * (the author of the node), allowing user tokens to be used when only
  4354. * a node data object is supplied.
  4355. * - tokens: An associative array of tokens. The outer array is keyed by the
  4356. * group name (the same key as in the types array). Within each group of
  4357. * tokens, each token item is keyed by the machine name of the token, and
  4358. * each token item has the following components:
  4359. * - name: The translated human-readable short name of the token.
  4360. * - description: A translated longer description of the token.
  4361. * - type (optional): A 'needs-data' data type supplied by this token, which
  4362. * should match a 'needs-data' value from another token type. For example,
  4363. * the node author token provides a user object, which can then be used
  4364. * for token replacement data in token_replace() without having to supply
  4365. * a separate user object.
  4366. *
  4367. * @see hook_token_info_alter()
  4368. * @see hook_tokens()
  4369. */
  4370. function hook_token_info() {
  4371. $type = array(
  4372. 'name' => t('Nodes'),
  4373. 'description' => t('Tokens related to individual nodes.'),
  4374. 'needs-data' => 'node',
  4375. );
  4376. // Core tokens for nodes.
  4377. $node['nid'] = array(
  4378. 'name' => t("Node ID"),
  4379. 'description' => t("The unique ID of the node."),
  4380. );
  4381. $node['title'] = array(
  4382. 'name' => t("Title"),
  4383. 'description' => t("The title of the node."),
  4384. );
  4385. $node['edit-url'] = array(
  4386. 'name' => t("Edit URL"),
  4387. 'description' => t("The URL of the node's edit page."),
  4388. );
  4389. // Chained tokens for nodes.
  4390. $node['created'] = array(
  4391. 'name' => t("Date created"),
  4392. 'description' => t("The date the node was posted."),
  4393. 'type' => 'date',
  4394. );
  4395. $node['author'] = array(
  4396. 'name' => t("Author"),
  4397. 'description' => t("The author of the node."),
  4398. 'type' => 'user',
  4399. );
  4400. return array(
  4401. 'types' => array('node' => $type),
  4402. 'tokens' => array('node' => $node),
  4403. );
  4404. }
  4405. /**
  4406. * Alter the metadata about available placeholder tokens and token types.
  4407. *
  4408. * @param $data
  4409. * The associative array of token definitions from hook_token_info().
  4410. *
  4411. * @see hook_token_info()
  4412. */
  4413. function hook_token_info_alter(&$data) {
  4414. // Modify description of node tokens for our site.
  4415. $data['tokens']['node']['nid'] = array(
  4416. 'name' => t("Node ID"),
  4417. 'description' => t("The unique ID of the article."),
  4418. );
  4419. $data['tokens']['node']['title'] = array(
  4420. 'name' => t("Title"),
  4421. 'description' => t("The title of the article."),
  4422. );
  4423. // Chained tokens for nodes.
  4424. $data['tokens']['node']['created'] = array(
  4425. 'name' => t("Date created"),
  4426. 'description' => t("The date the article was posted."),
  4427. 'type' => 'date',
  4428. );
  4429. }
  4430. /**
  4431. * Alter batch information before a batch is processed.
  4432. *
  4433. * Called by batch_process() to allow modules to alter a batch before it is
  4434. * processed.
  4435. *
  4436. * @param $batch
  4437. * The associative array of batch information. See batch_set() for details on
  4438. * what this could contain.
  4439. *
  4440. * @see batch_set()
  4441. * @see batch_process()
  4442. *
  4443. * @ingroup batch
  4444. */
  4445. function hook_batch_alter(&$batch) {
  4446. // If the current page request is inside the overlay, add ?render=overlay to
  4447. // the success callback URL, so that it appears correctly within the overlay.
  4448. if (overlay_get_mode() == 'child') {
  4449. if (isset($batch['url_options']['query'])) {
  4450. $batch['url_options']['query']['render'] = 'overlay';
  4451. }
  4452. else {
  4453. $batch['url_options']['query'] = array('render' => 'overlay');
  4454. }
  4455. }
  4456. }
  4457. /**
  4458. * Provide information on Updaters (classes that can update Drupal).
  4459. *
  4460. * An Updater is a class that knows how to update various parts of the Drupal
  4461. * file system, for example to update modules that have newer releases, or to
  4462. * install a new theme.
  4463. *
  4464. * @return
  4465. * An associative array of information about the updater(s) being provided.
  4466. * This array is keyed by a unique identifier for each updater, and the
  4467. * values are subarrays that can contain the following keys:
  4468. * - class: The name of the PHP class which implements this updater.
  4469. * - name: Human-readable name of this updater.
  4470. * - weight: Controls what order the Updater classes are consulted to decide
  4471. * which one should handle a given task. When an update task is being run,
  4472. * the system will loop through all the Updater classes defined in this
  4473. * registry in weight order and let each class respond to the task and
  4474. * decide if each Updater wants to handle the task. In general, this
  4475. * doesn't matter, but if you need to override an existing Updater, make
  4476. * sure your Updater has a lighter weight so that it comes first.
  4477. *
  4478. * @see drupal_get_updaters()
  4479. * @see hook_updater_info_alter()
  4480. */
  4481. function hook_updater_info() {
  4482. return array(
  4483. 'module' => array(
  4484. 'class' => 'ModuleUpdater',
  4485. 'name' => t('Update modules'),
  4486. 'weight' => 0,
  4487. ),
  4488. 'theme' => array(
  4489. 'class' => 'ThemeUpdater',
  4490. 'name' => t('Update themes'),
  4491. 'weight' => 0,
  4492. ),
  4493. );
  4494. }
  4495. /**
  4496. * Alter the Updater information array.
  4497. *
  4498. * An Updater is a class that knows how to update various parts of the Drupal
  4499. * file system, for example to update modules that have newer releases, or to
  4500. * install a new theme.
  4501. *
  4502. * @param array $updaters
  4503. * Associative array of updaters as defined through hook_updater_info().
  4504. * Alter this array directly.
  4505. *
  4506. * @see drupal_get_updaters()
  4507. * @see hook_updater_info()
  4508. */
  4509. function hook_updater_info_alter(&$updaters) {
  4510. // Adjust weight so that the theme Updater gets a chance to handle a given
  4511. // update task before module updaters.
  4512. $updaters['theme']['weight'] = -1;
  4513. }
  4514. /**
  4515. * Alter the default country list.
  4516. *
  4517. * @param $countries
  4518. * The associative array of countries keyed by ISO 3166-1 country code.
  4519. *
  4520. * @see country_get_list()
  4521. * @see _country_get_predefined_list()
  4522. */
  4523. function hook_countries_alter(&$countries) {
  4524. // Elbonia is now independent, so add it to the country list.
  4525. $countries['EB'] = 'Elbonia';
  4526. }
  4527. /**
  4528. * Control site status before menu dispatching.
  4529. *
  4530. * The hook is called after checking whether the site is offline but before
  4531. * the current router item is retrieved and executed by
  4532. * menu_execute_active_handler(). If the site is in offline mode,
  4533. * $menu_site_status is set to MENU_SITE_OFFLINE.
  4534. *
  4535. * @param $menu_site_status
  4536. * Supported values are MENU_SITE_OFFLINE, MENU_ACCESS_DENIED,
  4537. * MENU_NOT_FOUND and MENU_SITE_ONLINE. Any other value than
  4538. * MENU_SITE_ONLINE will skip the default menu handling system and be passed
  4539. * for delivery to drupal_deliver_page() with a NULL
  4540. * $default_delivery_callback.
  4541. * @param $path
  4542. * Contains the system path that is going to be loaded. This is read only,
  4543. * use hook_url_inbound_alter() to change the path.
  4544. */
  4545. function hook_menu_site_status_alter(&$menu_site_status, $path) {
  4546. // Allow access to my_module/authentication even if site is in offline mode.
  4547. if ($menu_site_status == MENU_SITE_OFFLINE && user_is_anonymous() && $path == 'my_module/authentication') {
  4548. $menu_site_status = MENU_SITE_ONLINE;
  4549. }
  4550. }
  4551. /**
  4552. * Register information about FileTransfer classes provided by a module.
  4553. *
  4554. * The FileTransfer class allows transferring files over a specific type of
  4555. * connection. Core provides classes for FTP and SSH. Contributed modules are
  4556. * free to extend the FileTransfer base class to add other connection types,
  4557. * and if these classes are registered via hook_filetransfer_info(), those
  4558. * connection types will be available to site administrators using the Update
  4559. * manager when they are redirected to the authorize.php script to authorize
  4560. * the file operations.
  4561. *
  4562. * @return array
  4563. * Nested array of information about FileTransfer classes. Each key is a
  4564. * FileTransfer type (not human readable, used for form elements and
  4565. * variable names, etc), and the values are subarrays that define properties
  4566. * of that type. The keys in each subarray are:
  4567. * - 'title': Required. The human-readable name of the connection type.
  4568. * - 'class': Required. The name of the FileTransfer class. The constructor
  4569. * will always be passed the full path to the root of the site that should
  4570. * be used to restrict where file transfer operations can occur (the $jail)
  4571. * and an array of settings values returned by the settings form.
  4572. * - 'file': Required. The include file containing the FileTransfer class.
  4573. * This should be a separate .inc file, not just the .module file, so that
  4574. * the minimum possible code is loaded when authorize.php is running.
  4575. * - 'file path': Optional. The directory (relative to the Drupal root)
  4576. * where the include file lives. If not defined, defaults to the base
  4577. * directory of the module implementing the hook.
  4578. * - 'weight': Optional. Integer weight used for sorting connection types on
  4579. * the authorize.php form.
  4580. *
  4581. * @see FileTransfer
  4582. * @see authorize.php
  4583. * @see hook_filetransfer_info_alter()
  4584. * @see drupal_get_filetransfer_info()
  4585. */
  4586. function hook_filetransfer_info() {
  4587. $info['sftp'] = array(
  4588. 'title' => t('SFTP (Secure FTP)'),
  4589. 'file' => 'sftp.filetransfer.inc',
  4590. 'class' => 'FileTransferSFTP',
  4591. 'weight' => 10,
  4592. );
  4593. return $info;
  4594. }
  4595. /**
  4596. * Alter the FileTransfer class registry.
  4597. *
  4598. * @param array $filetransfer_info
  4599. * Reference to a nested array containing information about the FileTransfer
  4600. * class registry.
  4601. *
  4602. * @see hook_filetransfer_info()
  4603. */
  4604. function hook_filetransfer_info_alter(&$filetransfer_info) {
  4605. if (variable_get('paranoia', FALSE)) {
  4606. // Remove the FTP option entirely.
  4607. unset($filetransfer_info['ftp']);
  4608. // Make sure the SSH option is listed first.
  4609. $filetransfer_info['ssh']['weight'] = -10;
  4610. }
  4611. }
  4612. /**
  4613. * @} End of "addtogroup hooks".
  4614. */
  4615. /**
  4616. * @addtogroup callbacks
  4617. * @{
  4618. */
  4619. /**
  4620. * Work on a single queue item.
  4621. *
  4622. * Callback for hook_cron_queue_info().
  4623. *
  4624. * @param $queue_item_data
  4625. * The data that was passed to DrupalQueueInterface::createItem() when the
  4626. * item was queued.
  4627. *
  4628. * @throws Exception
  4629. * The worker callback may throw an exception to indicate there was a problem.
  4630. * The cron process will log the exception, and leave the item in the queue to
  4631. * be processed again later.
  4632. *
  4633. * @see drupal_cron_run()
  4634. */
  4635. function callback_queue_worker($queue_item_data) {
  4636. $node = node_load($queue_item_data);
  4637. $node->title = 'Updated title';
  4638. node_save($node);
  4639. }
  4640. /**
  4641. * Return the URI for an entity.
  4642. *
  4643. * Callback for hook_entity_info().
  4644. *
  4645. * @param $entity
  4646. * The entity to return the URI for.
  4647. *
  4648. * @return
  4649. * An associative array with the following elements:
  4650. * - 'path': The URL path for the entity.
  4651. * - 'options': (optional) An array of options for the url() function.
  4652. * The actual entity URI can be constructed by passing these elements to
  4653. * url().
  4654. */
  4655. function callback_entity_info_uri($entity) {
  4656. return array(
  4657. 'path' => 'node/' . $entity->nid,
  4658. );
  4659. }
  4660. /**
  4661. * Return the label of an entity.
  4662. *
  4663. * Callback for hook_entity_info().
  4664. *
  4665. * @param $entity
  4666. * The entity for which to generate the label.
  4667. * @param $entity_type
  4668. * The entity type; e.g., 'node' or 'user'.
  4669. *
  4670. * @return
  4671. * An unsanitized string with the label of the entity.
  4672. *
  4673. * @see entity_label()
  4674. */
  4675. function callback_entity_info_label($entity, $entity_type) {
  4676. return empty($entity->title) ? 'Untitled entity' : $entity->title;
  4677. }
  4678. /**
  4679. * Return the language code of the entity.
  4680. *
  4681. * Callback for hook_entity_info().
  4682. *
  4683. * The language callback is meant to be used primarily for temporary alterations
  4684. * of the property value.
  4685. *
  4686. * @param $entity
  4687. * The entity for which to return the language.
  4688. * @param $entity_type
  4689. * The entity type; e.g., 'node' or 'user'.
  4690. *
  4691. * @return
  4692. * The language code for the language of the entity.
  4693. *
  4694. * @see entity_language()
  4695. */
  4696. function callback_entity_info_language($entity, $entity_type) {
  4697. return $entity->language;
  4698. }
  4699. /**
  4700. * @} End of "addtogroup callbacks".
  4701. */
  4702. /**
  4703. * @defgroup update_api Update versions of API functions
  4704. * @{
  4705. * Functions that are similar to normal API functions, but do not invoke hooks.
  4706. *
  4707. * These simplified versions of core API functions are provided for use by
  4708. * update functions (hook_update_N() implementations).
  4709. *
  4710. * During database updates the schema of any module could be out of date. For
  4711. * this reason, caution is needed when using any API function within an update
  4712. * function - particularly CRUD functions, functions that depend on the schema
  4713. * (for example by using drupal_write_record()), and any functions that invoke
  4714. * hooks.
  4715. *
  4716. * Instead, a simplified utility function should be used. If a utility version
  4717. * of the API function you require does not already exist, then you should
  4718. * create a new function. The new utility function should be named
  4719. * _update_N_mymodule_my_function(). N is the schema version the function acts
  4720. * on (the schema version is the number N from the hook_update_N()
  4721. * implementation where this schema was introduced, or a number following the
  4722. * same numbering scheme), and mymodule_my_function is the name of the original
  4723. * API function including the module's name.
  4724. *
  4725. * Examples:
  4726. * - _update_6000_mymodule_save(): This function performs a save operation
  4727. * without invoking any hooks using the 6.x schema.
  4728. * - _update_7000_mymodule_save(): This function performs the same save
  4729. * operation using the 7.x schema.
  4730. *
  4731. * The utility function should not invoke any hooks, and should perform database
  4732. * operations using functions from the
  4733. * @link database Database abstraction layer, @endlink
  4734. * like db_insert(), db_update(), db_delete(), db_query(), and so on.
  4735. *
  4736. * If a change to the schema necessitates a change to the utility function, a
  4737. * new function should be created with a name based on the version of the schema
  4738. * it acts on. See _update_7000_bar_get_types() and _update_7001_bar_get_types()
  4739. * in the code examples that follow.
  4740. *
  4741. * For example, foo.install could contain:
  4742. * @code
  4743. * function foo_update_dependencies() {
  4744. * // foo_update_7010() needs to run after bar_update_7000().
  4745. * $dependencies['foo'][7010] = array(
  4746. * 'bar' => 7000,
  4747. * );
  4748. *
  4749. * // foo_update_7036() needs to run after bar_update_7001().
  4750. * $dependencies['foo'][7036] = array(
  4751. * 'bar' => 7001,
  4752. * );
  4753. *
  4754. * return $dependencies;
  4755. * }
  4756. *
  4757. * function foo_update_7000() {
  4758. * // No updates have been run on the {bar_types} table yet, so this needs
  4759. * // to work with the 6.x schema.
  4760. * foreach (_update_6000_bar_get_types() as $type) {
  4761. * // Rename a variable.
  4762. * }
  4763. * }
  4764. *
  4765. * function foo_update_7010() {
  4766. * // Since foo_update_7010() is going to run after bar_update_7000(), it
  4767. * // needs to operate on the new schema, not the old one.
  4768. * foreach (_update_7000_bar_get_types() as $type) {
  4769. * // Rename a different variable.
  4770. * }
  4771. * }
  4772. *
  4773. * function foo_update_7036() {
  4774. * // This update will run after bar_update_7001().
  4775. * foreach (_update_7001_bar_get_types() as $type) {
  4776. * }
  4777. * }
  4778. * @endcode
  4779. *
  4780. * And bar.install could contain:
  4781. * @code
  4782. * function bar_update_7000() {
  4783. * // Type and bundle are confusing, so we renamed the table.
  4784. * db_rename_table('bar_types', 'bar_bundles');
  4785. * }
  4786. *
  4787. * function bar_update_7001() {
  4788. * // Database table names should be singular when possible.
  4789. * db_rename_table('bar_bundles', 'bar_bundle');
  4790. * }
  4791. *
  4792. * function _update_6000_bar_get_types() {
  4793. * db_query('SELECT * FROM {bar_types}')->fetchAll();
  4794. * }
  4795. *
  4796. * function _update_7000_bar_get_types() {
  4797. * db_query('SELECT * FROM {bar_bundles'})->fetchAll();
  4798. * }
  4799. *
  4800. * function _update_7001_bar_get_types() {
  4801. * db_query('SELECT * FROM {bar_bundle}')->fetchAll();
  4802. * }
  4803. * @endcode
  4804. *
  4805. * @see hook_update_N()
  4806. * @see hook_update_dependencies()
  4807. */
  4808. /**
  4809. * @} End of "defgroup update_api".
  4810. */